{"id":48736911,"url":"https://github.com/litecore-ai/ddd-coding-skills","last_synced_at":"2026-04-17T06:04:32.985Z","repository":{"id":349913711,"uuid":"1204478265","full_name":"litecore-ai/ddd-coding-skills","owner":"litecore-ai","description":"DDD development skill suite for coding agents — roadmap, implementation, audit.","archived":false,"fork":false,"pushed_at":"2026-04-12T03:24:32.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T05:23:35.784Z","etag":null,"topics":["architecture-audit","best-practices","claude-code","code-review","coding-agent","ddd","domain-driven-design","roadmap","skills","tdd"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/litecore-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-08T03:35:20.000Z","updated_at":"2026-04-12T03:24:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/litecore-ai/ddd-coding-skills","commit_stats":null,"previous_names":["litecore-ai/ddd-coding-skills"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/litecore-ai/ddd-coding-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litecore-ai%2Fddd-coding-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litecore-ai%2Fddd-coding-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litecore-ai%2Fddd-coding-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litecore-ai%2Fddd-coding-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/litecore-ai","download_url":"https://codeload.github.com/litecore-ai/ddd-coding-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litecore-ai%2Fddd-coding-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31826902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture-audit","best-practices","claude-code","code-review","coding-agent","ddd","domain-driven-design","roadmap","skills","tdd"],"created_at":"2026-04-12T05:03:31.145Z","updated_at":"2026-04-15T05:01:38.562Z","avatar_url":"https://github.com/litecore-ai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# DDD Coding Skill\n\nEnglish | [中文](README.zh-CN.md)\n\nA complete Domain-Driven Design development workflow for coding agents. Three composable skills that cover the full lifecycle: planning, implementing, and auditing.\n\n## How It Works\n\nThe three skills form a pipeline:\n\n```\nddd-roadmap  →  ddd-develop  →  ddd-audit\n (plan)         (implement)      (audit)\n```\n\n**ddd-roadmap** analyzes your project and generates a structured, phased roadmap with actionable checkbox items. Supports scoped roadmaps (`/ddd-roadmap billing system`) or full-project planning.\n\n**ddd-develop** picks the next unchecked roadmap item, generates an implementation plan, executes it with TDD via subagents, runs an audit, fixes all findings, and commits. Also supports ad-hoc requirements (`/ddd-develop add user authentication`). Self-contained — no external skill dependencies.\n\n**ddd-audit** performs an 8-dimension audit against DDD architecture standards: design, architecture, quality, security, testing, integration, performance, and observability. Supports scoped audits (`/ddd-audit src/domain/`) or full-project audits.\n\n## Skills\n\n| Skill | Purpose | Trigger |\n|-------|---------|---------|\n| **ddd-roadmap** | Generate phased development roadmap | `/ddd-roadmap`, `/ddd-roadmap \u003cscope\u003e` |\n| **ddd-develop** | Implement next roadmap item or ad-hoc requirement | `/ddd-develop`, `/ddd-develop \u003crequirement\u003e` |\n| **ddd-audit** | 8-dimension DDD architecture audit | `/ddd-audit`, `/ddd-audit \u003cscope\u003e` |\n\n### ddd-roadmap\n\nScans project structure, **auto-discovers product documentation** (PRD, specs, requirements) to extract vision and constraints, aligns on goals (validating extracted context when docs exist, or full Q\u0026A when they don't), decomposes features into actionable items, and organizes them into prioritized phases (P0-P3).\n\nThree input modes:\n- `/ddd-roadmap \u003cscope\u003e` — scoped roadmap for a specific feature area\n- `/ddd-roadmap` — full-project roadmap (when project has clear direction)\n- `/ddd-roadmap` — interactive (asks what to plan when scope is unclear)\n\nOutput: standardized checkbox-format roadmap in `docs/roadmap/`.\n\n### ddd-develop\n\nSelf-contained development workflow with 6 phases:\n\n1. **LOCATE** — Find development target (args / roadmap / ask user)\n2. **PLAN** — Generate bite-sized implementation plan with TDD steps\n3. **IMPLEMENT** — Subagent-per-task execution with spec + quality review loops\n4. **AUDIT** — Incremental DDD code review, fix ALL findings (all severity levels)\n5. **VERIFY** — Lint, type check, full test suite with evidence\n6. **COMPLETE** — Update roadmap (if applicable), commit, push (with user confirmation)\n\nThree input modes:\n- `/ddd-develop \u003crequirement\u003e` — develop an ad-hoc requirement (not in roadmap)\n- `/ddd-develop` — pick next unchecked roadmap item\n- `/ddd-develop` — interactive (asks what to develop when no roadmap items remain)\n\nBuilt-in: TDD (RED-GREEN-REFACTOR), implementation planning, subagent orchestration (implementer + spec reviewer + quality reviewer), and verification-before-completion.\n\n### ddd-audit\n\n8-dimension audit matrix with parallel subagent execution.\n\nThree input modes:\n- `/ddd-audit \u003cscope\u003e` — scoped audit of specific modules, layers, or files\n- `/ddd-audit` — full-project audit\n- `/ddd-audit` — interactive (asks what to audit when scope is unclear)\n\nDimensions:\n\n| Dimension | Focus |\n|-----------|-------|\n| D1 Design | Functional completeness, optimal approach |\n| D2 Architecture | DDD layer compliance, dependency direction |\n| D3 Quality | Dead code, duplication, complexity |\n| D4 Security | Vulnerabilities, edge cases, error handling |\n| D5 Testing | Coverage, test quality, boundary testing |\n| D6 Integration | Cross-module contracts, data flow |\n| D7 Performance | N+1 queries, caching, memory leaks |\n| D8 Observability | Logging, metrics, tracing |\n\nSupports incremental (diff) mode, configurable via `.audit-config.yml`, and generates scored reports with fix roadmaps.\n\n## Installation\n\n### Claude Code\n\n#### Option A: Plugin Marketplace (Recommended)\n\n```bash\nclaude plugin marketplace add litecore-ai/ddd-coding-skills\nclaude plugin install ddd-coding-skills@ddd-coding-skills\n```\n\n#### Option B: `--plugin-dir` Flag\n\n```bash\ngit clone https://github.com/litecore-ai/ddd-coding-skills.git ~/.local/share/claude/plugins/ddd-coding-skills\nclaude --plugin-dir ~/.local/share/claude/plugins/ddd-coding-skills\n```\n\n#### Option C: Manual Skill Installation\n\n```bash\ngit clone https://github.com/litecore-ai/ddd-coding-skills.git /tmp/ddd-coding-skills\n\n# Install as personal skills (available in all projects)\ncp -r /tmp/ddd-coding-skills/skills/ddd-roadmap ~/.claude/skills/ddd-roadmap\ncp -r /tmp/ddd-coding-skills/skills/ddd-develop ~/.claude/skills/ddd-develop\ncp -r /tmp/ddd-coding-skills/skills/ddd-audit ~/.claude/skills/ddd-audit\n\n# Or install as project-specific skills (version-controlled with your project)\ncp -r /tmp/ddd-coding-skills/skills/ddd-roadmap .claude/skills/ddd-roadmap\ncp -r /tmp/ddd-coding-skills/skills/ddd-develop .claude/skills/ddd-develop\ncp -r /tmp/ddd-coding-skills/skills/ddd-audit .claude/skills/ddd-audit\n```\n\n### Codex CLI\n\nClone and symlink for native skill discovery:\n\n```bash\ngit clone https://github.com/litecore-ai/ddd-coding-skills.git ~/.codex/ddd-coding-skills\nmkdir -p ~/.agents/skills\nln -s ~/.codex/ddd-coding-skills/skills ~/.agents/skills/ddd-coding-skills\n```\n\nEnable multi-agent support (required for ddd-develop subagent orchestration) in `~/.codex/config.toml`:\n\n```toml\n[features]\nmulti_agent = true\n```\n\nRestart Codex to discover the skills.\n\n\u003e **Windows:** Use a junction instead of a symlink — see [.codex/INSTALL.md](.codex/INSTALL.md) for details.\n\n## Updating\n\n### Claude Code — Plugin Marketplace\n\n```bash\nclaude plugin marketplace update ddd-coding-skills\nclaude plugin update ddd-coding-skills@ddd-coding-skills\n```\n\nRestart Claude Code after updating.\n\n### Claude Code — Manual Installation\n\n```bash\ncd /tmp/ddd-coding-skills \u0026\u0026 git pull\ncp -r skills/ddd-roadmap ~/.claude/skills/ddd-roadmap\ncp -r skills/ddd-develop ~/.claude/skills/ddd-develop\ncp -r skills/ddd-audit ~/.claude/skills/ddd-audit\n```\n\n### Codex CLI\n\n```bash\ncd ~/.codex/ddd-coding-skills \u0026\u0026 git pull\n```\n\nSkills update instantly through the symlink.\n\n## Usage Examples\n\n### Generate a Development Roadmap\n\n```\nYou: /ddd-roadmap\n\n# The skill will:\n# 1. Scan your project structure and tech stack\n# 2. Ask about your product goals and priorities\n# 3. Decompose features into actionable items\n# 4. Generate a phased roadmap (P0-P3) in docs/roadmap/\n```\n\nOr describe what you want directly:\n\n```\nYou: /ddd-roadmap I want to build a multi-tenant SaaS platform with user management, billing, and analytics\n```\n\n### Implement Features\n\nFrom roadmap (picks next unchecked item automatically):\n\n```\nYou: /ddd-develop\nYou: /ddd-develop   # next item\nYou: /ddd-develop   # next item\n```\n\nOr develop an ad-hoc requirement (not in roadmap):\n\n```\nYou: /ddd-develop add JWT authentication with refresh token rotation\n```\n\n### Audit Your Project\n\nFull project audit:\n\n```\nYou: /ddd-audit\n```\n\nScoped audit (specific module or layer):\n\n```\nYou: /ddd-audit src/domain/billing\nYou: /ddd-audit security review of auth module\n```\n\nIncremental mode (only recent changes):\n\n```\nYou: /ddd-audit --diff HEAD~3\n```\n\n### Full Workflow Example\n\nA typical end-to-end workflow:\n\n```\n# Step 1: Plan your project\nYou: /ddd-roadmap\n\n# Step 2: Implement features one by one\nYou: /ddd-develop\nYou: /ddd-develop\nYou: /ddd-develop\n\n# Step 3: Run a final audit before release\nYou: /ddd-audit\n```\n\n## Requirements\n\n- A coding agent with subagent support — [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [Codex CLI](https://github.com/openai/codex)\n- A project following (or adopting) DDD architecture patterns\n\n## Project Structure\n\n```\nddd-coding-skills/\n├── .claude-plugin/\n│   └── plugin.json          # Claude Code plugin manifest\n├── .codex/\n│   └── INSTALL.md           # Codex CLI installation guide\n├── skills/\n│   ├── ddd-roadmap/\n│   │   └── SKILL.md         # Roadmap generation\n│   ├── ddd-develop/\n│   │   └── SKILL.md         # Development workflow\n│   └── ddd-audit/\n│       └── SKILL.md         # 8-dimension audit\n├── LICENSE                  # MIT\n├── package.json\n└── README.md\n```\n\n## License\n\nMIT - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitecore-ai%2Fddd-coding-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flitecore-ai%2Fddd-coding-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitecore-ai%2Fddd-coding-skills/lists"}