AgileSDD

AgileSDD is a lean, installable starter for building software with a hybrid of Agile and Spec Driven Development.

The goal is not to force a heavy framework into every project. The goal is to give a developer a small, opinionated bootstrap that can be installed into a new or existing repo and immediately establish:

• a short AGENTS.md constitution
• lightweight architecture and roadmap docs
• a spec structure split by epic
• a small, curated skills/ set for clarification, architecture, and TDD
• a repeatable Spec -> Plan -> Tasks -> Implement -> Tests -> Review loop

Philosophy

AgileSDD is built around a few simple ideas:

• Keep context small. Agents should load only the docs they need.
• Keep docs as the source of truth. If something changes, the docs change first.
• Keep prompts and skills small. Reuse pieces, do not build mega-prompts.
• Keep the flow practical. The framework should help prototyping, not slow it down.
• Keep ownership clear. Developers manage Git flow and final approvals.

In short, AgileSDD is a "lean constitution + docs + workflow" approach to agent-assisted development.

What It Installs

When published, this package will act like a create-style CLI that scaffolds the workflow into a target project.

To scaffold a new project with the latest published version:

npm create agile-sdd@latest

Expected entry points:

• npm create agile-sdd@latest <target-dir>
• npx create-agile-sdd <target-dir>
• bunx create-agile-sdd <target-dir>
• npx create-agile-sdd --yes <target-dir>

For local development:

• node .\bin\create-agile-sdd.cjs <target-dir>

It generates the baseline docs and structure needed to start working with SDD Agile inside the destination project.

Behavior:

• If you run it in a terminal without enough information, it prompts for the missing target directory.
• If the target project already exists, it does not overwrite files unless you pass --force.
• Use --yes to skip confirmation prompts in automation-friendly runs.
• The installer can also set up a small recommended skills bundle during interactive setup, with grill-me defaulting to auto, zoom-out and tdd defaulting to manual, and --no-skills or --skills none to skip it entirely.

Core Docs

• AGENTS.md: the constitution for agents
• docs/WORKLOG.md: short repo-level execution tracking
• templates/base/: the default scaffold output installed into a target project

Credits

Some of the bundled skills are adapted from mattpocock/skills, which is published under the MIT license. Thanks to Matt Pocock for making those skills available as a practical base to learn from and build on.

Why This Exists

Most spec-driven frameworks are either too heavy, too verbose, or too eager to turn every project into a ritual. AgileSDD tries to stay useful when the project is still forming, when you want fast prototyping, and when you want agents to stay helpful instead of noisy while still feeling in control.

The target is a system that feels close to how a good product team actually works:

• a product-minded spec phase
• a planning phase that turns ideas into user stories
• a task phase that stays small and actionable
• an implementation and testing loop with room for review and correction

Current Status

This repository is the scaffold product itself. The next step is to keep the CLI and templates aligned, then publish the package for use in other projects.