Generate Specifications

Generate system specification YAML files by analyzing the codebase.

Step 1: Read Schemas and Documentation

Read the entire ${CLAUDE_PLUGIN_ROOT}/ folder to understand:

• README.md - Documentation, examples, and conventions
• schemas/ - JSON Schema definitions for each spec type

Step 2: Discovery Phase

Explore the codebase to discover what exists. Use TodoWrite to track discovered items by category.

Exclusions

DO NOT analyze:

• specs.build/
• .claude/, .git/, .github/, .rider/, .idea/, .vscode/
• node_modules/, dist/, build/, .svelte-kit/
• Paths matching patterns in .gitignore

Step 3: Generate Documentation

For each discovered item, generate a YAML spec file following the schemas. Write all output to specs.build/ with .yaml extension.

Rules:

• Only include fields defined in the schema
• Omit optional fields if not applicable

Output structure:

specs.build/
├── system.yaml
├── domain/
│   └── [entity]/
│       ├── [entity].yaml
│       └── actions/
│           └── [action].yaml
├── tasks/
│   └── [task].yaml
├── external-services/
│   └── [service].yaml
└── apps/
    └── [app]/
        └── [app].yaml

Step 4: Summary

Report items documented by category and any items needing manual review.