# 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 lives in `tasks.json`.** During the implement phase Claude records
> progress by writing `tasks.json` directly (only the `status`, `outputs`, and `notes`
> fields). State is synced automatically by the `state-sync` hook — there is no CLI
> command to mark a task done.

---

## 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*