@agents-skills-ai/sdd-agents — Specification-Driven Development (SDD) CLI

Fast, interactive scaffolding tool to set up INT Specification-Driven Development (SDD) v1.0 compliance across any codebase with a single command. Works with Antigravity, Claude Code, Cursor, Windsurf, GitHub Copilot, and OpenCode.

🚀 Quick Start in ANY Repository

1. Via NPX (Direct Execution)

Navigate to any project repository and run:

npx @agents-skills-ai/sdd-agents

(or npx @agents-skills-ai/sdd-agents init)

2. Local Development & Testing

If you are developing or testing this CLI locally on your machine:

# Inside C:\Users\SK_Jasimuddin\Desktop\sdd-agents-cli
npm link

# Now run 'sdd-agents' in ANY project folder!
cd F:\another-project
sdd-agents

🎯 What the CLI Generates

The tool creates the complete SDD structure required by the INT Engineering Guidelines:

your-project/
├── .agent/
│   ├── rules/
│   │   ├── int-standards.<stack>.md   # Tailored to selected tech stack
│   │   ├── .agentignore               # Context exclusion rules
│   │   └── auto-log.md                # Session audit logger rule
│   └── workflows/
│       ├── generate-plan.md           # Plan generation workflow
│       ├── generate-tests.md          # Red-phase test generator
│       └── code-review.md             # Gate 2 review checklist
├── .ai-context/
│   ├── constitution.md                # Project law & non-negotiables
│   ├── project_context.md             # High-level overview & tech stack
│   ├── architecture.md                # Living system design doc
│   ├── BRD.md                         # Business requirements backlog
│   ├── status.md                      # Live project status board
│   ├── prompt_history.md              # Session audit trail
│   ├── specs/_template.spec.md        # Spec template with API contract
│   ├── plans/_template.plan.md        # Technical plan template
│   ├── tasks/_template.tasks.md       # Task breakdown template
│   ├── test_cases/
│   │   └── _integration.md            # Cross-feature test journeys
│   └── decisions/
│       └── _template.adr.md           # Architecture decision record template
├── AGENTS.md                          # Universal root AI agent rules
├── CLAUDE.md                          # Claude Code rules (if selected)
├── .cursor/rules/sdd.mdc              # Cursor rules (if selected)
├── .windsurfrules                     # Windsurf Cascade rules (if selected)
└── .github/copilot-instructions.md    # GitHub Copilot rules (if selected)

📦 Supported Tech Stacks

• 📱 React Native (Expo / Bare React Native)
• ⚛️ React.js (Vite / CRA / Web)
• ▲ Next.js (App Router / Pages Router)
• 🟢 Node.js (Express / NestJS / Fastify)
• 🐍 Python (FastAPI / Django / Flask)
• ☕ Java (Spring Boot / Micronaut)
• 🔷 .NET / C# (ASP.NET Core)
• 💙 Flutter (Dart)

🛠️ Publishing to NPM (Optional)

To make npx sdd-agents available globally to all developers in INT:

# 1. Login to npm
npm login

# 2. Publish (public or scoped to @int/sdd-agents)
npm publish --access public

📄 License

MIT © Indus Net Technologies (INT)