Skip to content

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.md template (the root artifact)
    • New .the-loop/templates/brainstorm.md with front-matter + free-form sections.
    • Depends on: none
    • Requirements: R1
    • Test: markdownlint passes on the new file
  • [x] 2. Add the /brainstorm command
    • New commands/brainstorm.md — create/iterate/lock/convert flow.
    • Depends on: 1
    • Requirements: R2
    • Test: markdownlint passes; command references the template + next step
  • [x] 3. Wire brainstorming into config + manifest
    • config.schema.json (enum + default), config.yaml, templates/config.yaml, manifest.yaml (template + optional spec-brainstorm artifact).
    • Depends on: 1
    • Requirements: R1, R4
    • Test: python scripts/validate_config.py exits 0
  • [x] 4. Teach conversion + promotion
    • new-requirement.md derives from a locked sibling brainstorm; create-ticket.md carries brainstorm.md on promotion.
    • Depends on: 1
    • Requirements: R3
    • Test: markdownlint passes; 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.md and the decisions index.
    • Depends on: 1, 3
    • Requirements: R4, R5
    • Test: markdownlint passes on all changed docs
  • [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: markdownlint passes; validator still green

Dependency graph (DAG)

1 → 2
1 → 3 → 5
1 → 4
{1,3} → 5
{1..5} → 6

Checkpoints

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.

Released under the MIT License.