Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

RDD — Requirements-Driven Development

License: MIT

A skills.sh compatible skill for AI agents to converge fuzzy requirements into verifiable specs before writing code.

skills.sh

What is RDD?

RDD is a development methodology for AI Agent software engineering. Its core goal is not to make LLMs generate code faster, but to build a complete requirements convergence chain from human intent to reliable software implementation:

Human Intent
    ↓
Requirement Engineering (What to build? Why? Where are the boundaries?)
    ↓
Specification Engineering (What behavior must the system exhibit?)
    ↓
Implementation (Code + tests, AC as test contracts)
    ↓
Verification (Run real app, browser automation, integrity checks)

Install

# Install via skills.sh CLI
npx skills add anyJohn/OpenReq

# Or clone manually
git clone https://github.com/anyJohn/OpenReq.git ~/.claude/skills/rdd

Key Concepts

  • Work Items: RR → Feature → Story → Task, with status tracking
  • Spec: Structured behavior/constraint/invariant model with uncertainty labels (confirmed/inferred/unresolved)
  • Decisions: First-class artifacts, frozen after human approval
  • Three scenario paths: A (incremental), B (full replacement), C (lightweight)
  • Artifact shelf-life: permanent / migration-only / session-only
  • AC as test contract: No separate TEST files — tests written with implementation
  • Lite channel: Skip US split for small changes, single-file spec
  • Git as artifact store: Commit message + docs/specs/ for solo dev

Structure

OpenReq/
├── skills/
│   └── rdd/
│       ├── SKILL.md              # Main skill (frontmatter + full methodology)
│       └── references/
│           ├── templates.md      # RR / Spec / Traceability templates
│           └── rdd-design.md     # Full design document (30+ sections)
├── skills.sh.json               # Category metadata for skills.sh
├── README.md
└── LICENSE

Usage

Once installed, tell your AI agent:

用 RDD 流程开发:把 web 从 Vue 迁移到 React
RDD: 需求收敛一下,这个功能还没想清楚
先理清再动手,别直接改代码

The agent will follow the RDD flow: Impact Analysis → Requirement Engineering → Specification → Implementation → Verification.

License

MIT

About

RDD(Requirements-Driven Development,需求驱动开发)是一套面向 AI Agent 软件工程的开发架构。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors