SDSection 6 →

Section 5

Module 5: Tooling and Ecosystem

Agent OS for the feature lifecycle, high-rigor agentic IDEs like Amazon Kiro, and MCP as the runtime bridge to your stack.

Module 53 lessons · ~19 min
"Specs define intent. Tooling enforces the lifecycle and connects agents to reality at runtime.

Lessons

Kiro spec triad

requirements.md (what), design.md (how), tasks.md (steps) — each with clear must-include rules.

Full needs & requirements
requirements.mdWhat

Defines what is being built — user outcomes and acceptance criteria (EARS).

design.mdHow

Architecture and approach before implementation — structure agents must follow.

tasks.mdSteps

Concrete, ordered work the AI executes one task at a time with verification.

Feature lifecycle (Agent OS)

Each stage is a system call — agents and humans run the same pipeline.

/plan product

Once at project start — plan.md, roadmap.md, techstack.md as durable context.

High-rigor documentation artifacts

FileProblem it prevents
plan.mdFeature drift
roadmap.mdPriority hallucinations
techstack.mdStack guessing
Loading AgentOS memory…

Practical Takeaways

  1. 1AgentOS: /plan product → plan.md, roadmap.md, techstack.md; shape-spec → requirements gate; /create-tasks → atomic tasks.md.
  2. 2Choose implement tasks (control) or orchestrate tasks (speed) — specialists see only relevant context.
  3. 3Kiro-class rigor: requirements.md + design.md + tasks.md with EARS and evidence before code.
  4. 4plan.md, roadmap.md, techstack.md prevent feature drift, priority hallucinations, and stack guessing.
  5. 5steering.md: persistent memory (stack, standards); requirements.md: the what for one feature on the execution spine.
  6. 6MCP + Runtime Gateflow: Playwright → DevTools evidence → map to spec → propose verified fix.
  7. 7High-rigor tooling turns SDD from philosophy into repeatable, auditable practice.

Model Context Protocol

How MCP bridges agents to repos, logs, and APIs.

Open MCP lesson

SDD workflow map

See shape-spec through verify in one view.

Interactive workflow