Tasks: a brainstorm phase and /brainstorm command
Derived from the approved
design.md. Docs/plugin-content change — the "tests" are the config validator and markdownlint (see design → Testing strategy).
Task list
- [x] 1. Add the
brainstorm.mdtemplate (the root artifact)- New
.the-loop/templates/brainstorm.mdwith front-matter + free-form sections. - Depends on: none
- Requirements: R1
- Test:
markdownlintpasses on the new file
- New
- [x] 2. Add the
/brainstormcommand- New
commands/brainstorm.md— create/iterate/lock/convert flow. - Depends on: 1
- Requirements: R2
- Test:
markdownlintpasses; command references the template + next step
- New
- [x] 3. Wire
brainstorminginto config + manifestconfig.schema.json(enum + default),config.yaml,templates/config.yaml,manifest.yaml(template + optionalspec-brainstormartifact).- Depends on: 1
- Requirements: R1, R4
- Test:
python scripts/validate_config.pyexits 0
- [x] 4. Teach conversion + promotion
new-requirement.mdderives from a locked sibling brainstorm;create-ticket.mdcarriesbrainstorm.mdon promotion.- Depends on: 1
- Requirements: R3
- Test:
markdownlintpasses; inspection of the two command files
- [x] 5. Generalize the iterate-until-locked rule in docs
- Update
work-on.md,SKILL.md,reference/workflow.md,README.md(chain, optional phase, state machine, the rule) +decision-017.mdand the decisions index. - Depends on: 1, 3
- Requirements: R4, R5
- Test:
markdownlintpasses on all changed docs
- Update
- [x] 6. Dogfood: write the issue-17 spec
docs/specs/issue-17/{brainstorm,requirements,design,tasks,execution-log}.md.- Depends on: 1–5
- Requirements: R1–R5 (demonstration)
- Test:
markdownlintpasses; validator still green
Dependency graph (DAG)
1 → 2
1 → 3 → 5
1 → 4
{1,3} → 5
{1..5} → 6Checkpoints
After task 3 and again after task 6: run python scripts/validate_config.py and pre-commit run --all-files (ruff/pyright/markdownlint/schema) — record the outcome in execution-log.md.