--- name: domain-population description: Populate domain specs (glossary, entity definitions, use-cases) from discovery results. --- # Domain Population Skill Populates the domain specification files with content extracted from product discovery. ## Purpose After project scaffolding, this skill: - Updates `specs\/domain\/glossary.md` with discovered entities - Creates entity definition stubs in `specs\/domain\/definitions\/` - Creates use-case stubs in `specs\/domain\/use-cases\/` - Updates `specs\/SNAPSHOT.md` with product overview ## When to Use - During `\/sdd-init` after scaffolding completes - When refreshing domain specs from new discovery - When importing domain concepts from external specs ## Usage This skill uses a TypeScript script for deterministic file creation: ```bash # 1. Create a config JSON file cat > \/tmp\/sdd-domain-config.json << 'EOF' { "target_dir": "\/path\/to\/project", "primary_domain": "Task Management", "product_description": "Task management for engineering teams", "user_personas": [ {"type": "Project Manager", "actions": "create projects, assign tasks"}, {"type": "Team Member", "actions": "update progress"} ], "core_workflows": ["Create projects", "Assign tasks", "Update progress"], "domain_entities": ["Team", "Project", "Task", "User"] } EOF # 2. Run the domain population script npx ts-node --esm \/skills\/domain-population\/domain-population.ts --config \/tmp\/sdd-domain-config.json # 3. Clean up config file rm \/tmp\/sdd-domain-config.json ``` ## Input | Field | Required | Description | |-------|----------|-------------| | `target_dir` | Yes | Absolute path to the project directory | | `primary_domain` | Yes | Primary business domain | | `product_description` | Yes | 1-2 sentence problem statement | | `user_personas` | No | List of user types with actions | | `core_workflows` | No | List of main capabilities | | `domain_entities` | No | List of domain entity names | ## Output ```yaml success: true files_updated: - specs\/domain\/glossary.md - specs\/domain\/definitions\/team.md - specs\/domain\/definitions\/project.md - specs\/domain\/definitions\/task.md - specs\/domain\/definitions\/user.md - specs\/domain\/use-cases\/create-projects.md - specs\/domain\/use-cases\/assign-tasks.md - specs\/domain\/use-cases\/update-progress.md - specs\/SNAPSHOT.md ``` ## File Templates ### Glossary Entry Format For each entity, add a row to `specs\/domain\/glossary.md`: ```markdown | | | | ``` ### Entity Definition Stub Creates `specs\/domain\/definitions\/.md`: ```markdown --- name: domain: status: draft --- # ## Description ## Attributes | Attribute | Type | Description | |-----------|------|-------------| | (to be defined) | | | ## Relationships - (to be defined) ## States (if applicable) (to be defined) ``` ### Use-Case Stub Creates `specs\/domain\/use-cases\/.md`: ```markdown --- name: domain: actors: status: draft --- # ## Summary ## Actors - ## Preconditions (to be defined) ## Main Flow 1. (to be defined) ## Postconditions (to be defined) ``` ### SNAPSHOT.md Product Overview Adds to `specs\/SNAPSHOT.md`: ```markdown ## Product Overview **Problem:** **Target Users:** - : - : **Core Capabilities:** - - **Key Entities:** , , ``` ## Example ### Input ```json { "target_dir": "\/Users\/dev\/my-task-tracker", "primary_domain": "Task Management", "product_description": "Task management for engineering teams", "user_personas": [ {"type": "Project Manager", "actions": "create projects, assign tasks"}, {"type": "Team Member", "actions": "update progress, view assignments"} ], "core_workflows": [ "Create projects", "Assign tasks", "Update task progress" ], "domain_entities": ["Team", "Project", "Task", "User"] } ``` ### Output ``` Populating domain specs for: Task Management Creating entity definitions... Created: specs\/domain\/definitions\/team.md Created: specs\/domain\/definitions\/project.md Created: specs\/domain\/definitions\/task.md Created: specs\/domain\/definitions\/user.md Creating use-case stubs... Created: specs\/domain\/use-cases\/create-projects.md Created: specs\/domain\/use-cases\/assign-tasks.md Created: specs\/domain\/use-cases\/update-task-progress.md Updating glossary... Updated: specs\/domain\/glossary.md Updating SNAPSHOT... Updated: specs\/SNAPSHOT.md ============================================================ Domain population complete! ============================================================ Created 4 entity definitions Created 3 use-case stubs Updated glossary with 4 entries Updated SNAPSHOT with product overview ``` ## Notes - Uses TypeScript for deterministic file creation - Preserves existing content in glossary and SNAPSHOT (appends\/merges) - Creates slugified filenames (lowercase, hyphens) - All files are stubs meant to be filled in later