القائمة
Use when validating design documents or troubleshooting issues. Trigger with design management ops request. Loaded by ai-maestro-architect-agent-main-agent
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when decomposing systems into modules with clear boundaries. Trigger with modularization or module boundary request. Loaded by ai-maestro-architect-agent-main-agent
Use when designing architectures, identifying risks, creating roadmaps, or breaking work into tasks. Trigger with planning or architecture design request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing requirements, initializing plans, or approving transitions. Trigger with requirements analysis or plan initialization request. Loaded by ai-maestro-architect-agent-main-agent
Use when recording stack choices, constraints, or managing handoffs. Trigger with session memory ops request. Loaded by ai-maestro-architect-agent-main-agent
Use when persisting decisions, patterns, and constraints across sessions. Trigger with session memory or handoff request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing design document states or lifecycle transitions. Trigger with design lifecycle or state transition request. Loaded by ai-maestro-architect-agent-main-agent
| name | amaa-design-management-ops |
| description | Use when validating design documents or troubleshooting issues. Trigger with design management ops request. Loaded by ai-maestro-architect-agent-main-agent |
| context | fork |
| user-invocable | false |
| agent | ai-maestro-architect-agent-main-agent |
Covers validation, troubleshooting, and quick reference for design document management. Use after documents are created to ensure compliance and resolve issues.
design/ directory structure existsamaa_design_validate.pyCopy this checklist and track your progress:
amaa_design_validate.py| Document | Content |
|---|---|
| validating-documents.md | Single File Validation, Bulk Validation, Understanding Errors, Understanding Warnings, Error Resolution, Required Frontmatter Fields, Script Reference |
| troubleshooting.md | UUID Generation Issues, Creation Failures, Search Issues, Frontmatter Parsing Issues, Directory Structure Issues, Permission Issues, Encoding Issues |
| quick-reference.md | Quick Reference Commands, Document Status Workflow, Frontmatter Reference, Directory Structure, Extended Examples |
Example: python scripts/amaa_design_validate.py --all validates all design documents and reports errors.
| Issue | Fix |
|---|---|
| Validation: malformed frontmatter | Fix YAML delimiters and field formatting |
| Files in wrong directory | Move to correct design/<type>/ subdirectory |
| Encoding errors | Ensure files are UTF-8 encoded |
| Type | Description |
|---|---|
| Validation Report | Error list with file paths and line numbers |
| Quick Reference | Command patterns for common operations |
See Reference Documents table above.