@polymorphism-tech/morph-spec 7.4.0 → 7.5.0

package/framework/templates/docs/onboarding.md

@@ -1,118 +1,122 @@
-# Onboarding Guide — {{PROJECT_NAME}}
-
-> Generated by MORPH-SPEC on {{DATE}}
-
----
-
-## Project Overview
-
-- **Project:** {{PROJECT_NAME}}
-- **Stack:** {{STACK}}
-- **Architecture:** {{ARCHITECTURE}}
-
----
-
-## Active Agents
-
-The following agents are configured for this project:
-
-{{AGENTS_LIST}}
-
----
-
-## Available MCPs & Plugins
-
-{{AVAILABLE_MCPS}}
-
----
-
-## Standards
-
-The following standards are enforced in this project:
-
-{{STANDARDS_SUMMARY}}
-
-Standards are located in:
-- `.morph/framework/standards/` — Framework standards (universal)
-- `.morph/context/` — Project-specific overrides
-
----
-
-## Configured Workflow
-
-{{WORKFLOW_SUMMARY}}
-
-### Available Workflows
-
-| Workflow | Description | Phases |
-|----------|-------------|--------|
-| fast-track | Simple, well-defined features | 0→1→2→4→5 |
-| standard | Most features | 0→1→(1.5)→2→3→4→5 |
-| full-morph | Complex features with sync | 0→1→1.5→2→3→4→5→6 |
-| design-impl | Pre-planned work | 2→4→5 |
-| ui-refresh | Visual redesigns | 1.5→2→5 |
-
----
-
-## Key Commands
-
-```bash
-# Start a feature
-# Just ask Claude Code to implement something
-
-# Check feature progress
-morph-spec status <feature>
-
-# Validate feature outputs
-morph-spec validate-feature <feature>
-
-# Manage tasks
-morph-spec task start <feature> <task-id>
-morph-spec task done <feature> <task-id>
-
-# Save a checkpoint
-morph-spec checkpoint-save <feature>
-
-# Health check
-morph-spec doctor
-```
-
----
-
-## Project Structure
-
-```
-{{PROJECT_NAME}}/
-├── CLAUDE.md                      # Claude Code instructions
-├── .morph/
-│   ├── config/
-│   │   └── config.json            # Project configuration
-│   ├── framework/
-│   │   ├── agents.json            # Agent definitions
-│   │   ├── standards/             # Framework standards
-│   │   └── templates/             # Output templates
-│   ├── context/                   # Project context & overrides
-│   └── features/{feature}/        # Feature outputs
-│       ├── 0-proposal/
-│       ├── 1-design/              # optional (UI-heavy features)
-│       ├── 2-plan/
-│       ├── 3-implement/
-│       └── 4-review/
-└── .claude/
-    ├── commands/                  # Slash commands
-    ├── skills/                    # Workflow skills
-    └── settings.local.json        # Hooks & permissions
-```
-
----
-
-## Getting Started
-
-1. **Ask Claude Code** to implement a feature
-2. **Follow the phases** — the framework guides you automatically
-3. **Approve at pauses** — design and task breakdowns need your approval
-4. **Check progress** with `morph-spec status <feature>`
-
----
-
-*Generated by MORPH-SPEC v{{VERSION}} — Polymorphism Tech*
+# Onboarding Guide — {{PROJECT_NAME}}
+
+> Generated by MORPH-SPEC on {{DATE}}
+
+---
+
+## Project Overview
+
+- **Project:** {{PROJECT_NAME}}
+- **Stack:** {{STACK}}
+- **Architecture:** {{ARCHITECTURE}}
+
+---
+
+## Active Agents
+
+The following agents are configured for this project:
+
+{{AGENTS_LIST}}
+
+---
+
+## Available MCPs & Plugins
+
+{{AVAILABLE_MCPS}}
+
+---
+
+## Standards
+
+The following standards are enforced in this project:
+
+{{STANDARDS_SUMMARY}}
+
+Standards are located in:
+- `.morph/framework/standards/` — Framework standards (universal)
+- `.morph/context/` — Project-specific overrides
+
+---
+
+## Configured Workflow
+
+{{WORKFLOW_SUMMARY}}
+
+### Available Workflows
+
+| Workflow | Description | Phases |
+|----------|-------------|--------|
+| fast-track | Simple, well-defined features | 0→1→2→4→5 |
+| standard | Most features | 0→1→(1.5)→2→3→4→5 |
+| full-morph | Complex features with sync | 0→1→1.5→2→3→4→5→6 |
+| design-impl | Pre-planned work | 2→4→5 |
+| ui-refresh | Visual redesigns | 1.5→2→5 |
+
+---
+
+## Key Commands
+
+```bash
+# Start a feature
+# Just ask Claude Code to implement something
+
+# Check feature progress
+morph-spec status <feature>
+
+# Validate feature outputs
+morph-spec validate-feature <feature>
+
+# Approve the current gate and scaffold the next phase folder
+morph-spec advance <feature>
+
+# Archive a finished feature (after Gate 3)
+morph-spec archive <feature>
+
+# Health check
+morph-spec doctor
+```
+
+> **Task tracking is native.** During the implement phase Claude tracks its own
+> work with the `TaskCreate`/`TaskUpdate` tools and persists progress by writing
+> `tasks.json` (only the `status`, `outputs`, and `notes` fields). State is synced
+> automatically by the `state-sync` hook — task tracking is native, not a CLI command.
+
+---
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── CLAUDE.md                      # Claude Code instructions
+├── .morph/
+│   ├── config/
+│   │   └── config.json            # Project configuration
+│   ├── framework/
+│   │   ├── agents.json            # Agent definitions
+│   │   ├── standards/             # Framework standards
+│   │   └── templates/             # Output templates
+│   ├── context/                   # Project context & overrides
+│   └── features/{feature}/        # Feature outputs
+│       ├── 0-proposal/
+│       ├── 1-design/              # optional (UI-heavy features)
+│       ├── 2-plan/
+│       ├── 3-implement/
+│       └── 4-review/
+└── .claude/
+    ├── commands/                  # Slash commands
+    ├── skills/                    # Workflow skills
+    └── settings.local.json        # Hooks & permissions
+```
+
+---
+
+## Getting Started
+
+1. **Ask Claude Code** to implement a feature
+2. **Follow the phases** — the framework guides you automatically
+3. **Approve at pauses** — design and task breakdowns need your approval
+4. **Check progress** with `morph-spec status <feature>`
+
+---
+
+*Generated by MORPH-SPEC v{{VERSION}} — Polymorphism Tech*

package/framework/templates/docs/proposal.md

@@ -21,6 +21,16 @@
 
 ---
 
+## Acceptance Criteria
+
+Verifiable conditions that mean this feature is done:
+
+- [ ] {Criterion 1 — observable / testable}
+- [ ] {Criterion 2}
+- [ ] {Criterion 3}
+
+---
+
 ## Problem Statement
 
 ### What is the problem?