## Developer TODO (Project Mode)

### BUILD

```
1. Create _docs/00_problem/                      — describe what you're building
   - problem.md                                   (required)
   - restrictions.md                              (required)
   - acceptance_criteria.md                       (required)
   - input_data/                                  (required)
   - security_approach.md                         (optional)

2. /research                                     — solution drafts → _docs/01_solution/
   Run multiple times: Mode A → draft, Mode B → assess & revise

3. /plan                                         — architecture, data model, deployment, components, risks, tests, Jira epics → _docs/02_plans/

4. /decompose                                    — atomic task specs + dependency table → _docs/02_tasks/

5. /implement                                    — batched parallel agents, code review, commit per batch → _docs/03_implementation/
```

### SHIP

```
6. /deploy                                       — containerization, CI/CD, environments, observability, procedures → _docs/02_plans/deployment/
```

### EVOLVE

```
7. /refactor                                     — structured refactoring → _docs/04_refactoring/
8. /retrospective                                — metrics, trends, improvement actions → _docs/05_metrics/
```

## Available Skills

| Skill | Triggers | Output |
|-------|----------|--------|
| **research** | "research", "investigate" | `_docs/01_solution/` |
| **plan** | "plan", "decompose solution" | `_docs/02_plans/` |
| **decompose** | "decompose", "task decomposition" | `_docs/02_tasks/` |
| **implement** | "implement", "start implementation" | `_docs/03_implementation/` |
| **code-review** | "code review", "review code" | Verdict: PASS / FAIL / PASS_WITH_WARNINGS |
| **refactor** | "refactor", "improve code" | `_docs/04_refactoring/` |
| **security** | "security audit", "OWASP" | Security findings report |
| **deploy** | "deploy", "CI/CD", "observability" | `_docs/02_plans/deployment/` |
| **retrospective** | "retrospective", "retro" | `_docs/05_metrics/` |
| **rollback** | "rollback", "revert batch" | `_docs/03_implementation/rollback_report.md` |

## Tools

| Tool | Type | Purpose |
|------|------|---------|
| `implementer` | Subagent | Implements a single task. Launched by `/implement`. |

## Project Folder Structure

```
_docs/
├── 00_problem/                          — problem definition, restrictions, AC, input data
├── 00_research/                         — intermediate research artifacts
├── 01_solution/                         — solution drafts, tech stack, security analysis
├── 02_plans/
│   ├── architecture.md
│   ├── system-flows.md
│   ├── data_model.md
│   ├── risk_mitigations.md
│   ├── components/[##]_[name]/          — description.md + tests.md per component
│   ├── common-helpers/
│   ├── integration_tests/               — environment, test data, functional, non-functional, traceability
│   ├── deployment/                      — containerization, CI/CD, environments, observability, procedures
│   ├── diagrams/
│   └── FINAL_report.md
├── 02_tasks/                            — [JIRA-ID]_[name].md + _dependencies_table.md
├── 03_implementation/                   — batch reports, rollback report, FINAL report
├── 04_refactoring/                      — baseline, discovery, analysis, execution, hardening
└── 05_metrics/                          — retro_[YYYY-MM-DD].md
```

## Standalone Mode

`research` and `refactor` support standalone mode — output goes to `_standalone/` (git-ignored):

```
/research @my_problem.md
/refactor @some_component.md
```

## Single Component Mode (Decompose)

```
/decompose @_docs/02_plans/components/03_parser/description.md
```

Appends tasks for that component to `_docs/02_tasks/` without running bootstrap or cross-verification.