Skip to content

quangdang46/qd

Repository files navigation

QD Framework

AI-Driven Development Methodology - A breakthrough method for agile development powered by AI agents.

Quick Start

# Initialize QD for Claude Code
npx qdspec init --ides claude-code

# Or initialize for multiple IDEs
npx qdspec init --ides claude-code,cursor,codex

Installation

From npm (production)

npm install -g qdspec
qdspec init --ides <your-ide>

Development Mode

git clone https://github.com/quangdang46/qd.git
cd qd
pnpm install
pnpm build

# Run in dev mode (artifacts downloaded from GitHub Releases at init)
# Use QD_SPEC_PATH=/path/to/spec/artifacts for local artifacts
qdspec init --ides claude-code

CLI Commands

qdspec init

Initialize QD artifacts for selected IDEs.

qdspec init --ides claude-code,cursor,codex  # Initialize for multiple IDEs
qdspec init --ides claude-code --version v0.1.0  # Install specific version
qdspec init --ides cursor --no-cache  # Bypass cache
qdspec init --directory /path/to/project  # Initialize in specific directory

qdspec status

Display installation status.

qdspec status  # Check current directory
qdspec status --directory /path/to/project  # Check specific directory

qdspec remove

Remove QD from a project.

qdspec remove  # Interactive mode
qdspec remove --yes  # Remove without prompting
qdspec remove --directory /path/to/project  # Remove from specific directory

Supported IDEs

IDE Command
Claude Code --ides claude-code
Cursor --ides cursor
Codex --ides codex
Windsurf --ides windsurf
GitHub Copilot --ides github-copilot
Gemini CLI --ides gemini
And 20+ more...

Run qd init --ides to see all available IDEs.

Architecture

qd/
├── src/               # Source code
│   ├── commands/      # CLI commands
│   ├── domains/       # Domain logic
│   └── ...
├── dist/              # Compiled output
└── test/              # Test files

Versioning

QD uses a two-part release system:

  1. CLI - Published to npm
  2. Spec - Published to GitHub Releases of the spec repository

When you run qdspec init, the CLI downloads artifacts from the latest GitHub release of the spec repository.

License

MIT

About

Resources

Stars

Watchers

Forks

Contributors