apac-sdlc

CLI tool that scaffolds SDLC-focused Claude Code skills, knowledge base patterns, and Spec-Driven Development workflows into any project.

Install

npm install -g apac-sdlc

Or run without installing:

npx apac-sdlc <command>

Commands

init — Install generic SDLC skills

Installs skills into .claude/skills/. Re-running is safe — existing skills are skipped.

apac-sdlc init

| Skill | Trigger | Description | | --- | --- | --- | | requirement | /requirement | Turn an idea into user stories with acceptance criteria | | estimation | /estimation | Break an epic into sized tasks with dependencies | | code-review | /code-review | Review code for bugs, style, and best practices | | commit-msg | /commit-msg | Generate a Conventional Commits message from staged diff | | pr-description | /pr-description | Generate PR title and description from staged diff | | security-review | /security-review | OWASP-focused security audit of changed files |

add <name> --pattern <pattern> — Knowledge base patterns

Creates a <name>/ folder using the specified pattern. Also updates (or creates) root CLAUDE.md so Claude Code is aware of it. Re-running is safe — existing folders and CLAUDE.md sections are skipped.

llm-wiki — LLM-maintained personal knowledge base

apac-sdlc add knowledge-base --pattern llm-wiki

Scaffolds:

knowledge-base/
├── raw/          ← drop source documents here (immutable)
│   └── assets/
├── wiki/         ← LLM writes and maintains all pages
│   ├── index.md  ← master catalog
│   └── log.md    ← append-only operation history
├── CLAUDE.md     ← wiki schema and LLM instructions
└── README.md     ← usage guide

Open with Claude Code:

cd knowledge-base && claude

Key operations:

• Ingest: ingest raw/my-article.md — processes source into wiki
• Query: ask questions directly — Claude reads wiki/index.md first
• Lint: lint the wiki — finds contradictions, orphans, stale claims

graphify — Knowledge graph (requires Python 3.10+)

apac-sdlc add knowledge-base --pattern graphify

Scaffolds:

knowledge-base/
├── raw/              ← drop source documents here (immutable)
├── graphify-out/     ← graph output (graph.html, GRAPH_REPORT.md, graph.json)
├── CLAUDE.md         ← graphify usage instructions
└── README.md         ← setup and usage guide

Also:

• Installs graphifyy Python package (uv / pipx / pip)
• Runs graphify install to register the /graphify skill in Claude Code
• Creates .graphifyignore at project root (auto-detects Node/Python/Go/Rust/Java)

Key operations:

• Build: /graphify raw/ — maps sources into graph
• Update: /graphify raw/ --update — re-extract changed files only
• Query: /graphify query "..." — search the graph

add sdd — Spec-Driven Development workflow

Injects a full SDD workflow into a project. Auto-detects greenfield vs brownfield.

apac-sdlc add sdd [path] --framework <name>

| Option | Description | | --- | --- | | --framework <name> | SDD framework (default: spec-kit) | | --mode auto\|green\|brown | Override auto-detection (default: auto) | | --dry-run | Preview files — nothing is written | | --force | Overwrite existing files |

Examples

apac-sdlc add sdd                              # spec-kit, current dir
apac-sdlc add sdd --dry-run                    # preview
apac-sdlc add sdd ~/my-project                 # specific path
apac-sdlc add sdd ~/my-project --framework spec-kit
apac-sdlc add sdd ~/my-project --mode green    # force greenfield
apac-sdlc add sdd ~/my-project --force         # overwrite existing files

What spec-kit generates

<project>/
  .claude/
    CLAUDE.md                        # Created fresh (greenfield) or merged (brownfield)
    skills/
      code-review/SKILL.md
      pr-description/SKILL.md
      security-review/SKILL.md
      speckit/SKILL.md               # /speckit
      speckit-constitution/SKILL.md
      speckit-specify/SKILL.md
      speckit-clarify/SKILL.md
      speckit-plan/SKILL.md
      speckit-tasks/SKILL.md
      speckit-analyze/SKILL.md
      speckit-implement/SKILL.md
  .specify/
    memory/constitution.md
    templates/
    workflows/speckit/workflow.yml
    scripts/bash/
    extensions/git/
    init-options.json

SDD workflow cycle

| Step | Command | Gate | | --- | --- | --- | | 0 | /speckit-constitution | Fill in once, before anything else | | 1 | /speckit-specify | Describe the feature | | — | review gate | Approve spec before planning | | 2 | /speckit-plan | Technical architecture | | — | review gate | Approve plan before tasks | | 3 | /speckit-tasks | Atomic task breakdown | | 4 | /speckit-analyze | Cross-artifact consistency check | | — | review gate | Resolve CRITICAL issues before implementing | | 5 | /speckit-implement | Execute one task at a time |

On-demand: /speckit-clarify — resolve spec ambiguities between steps 1 and 2.

Brownfield detection

Brownfield if any of these exist: package.json, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, pyproject.toml, Makefile, *.sln, or directories src/, app/, lib/, cmd/, pkg/, backend/, frontend/.

If .claude/CLAUDE.md already exists, the speckit section is appended — existing content is never overwritten. Re-running is idempotent.

Development

Prerequisites

• Node.js 18+
• npm

Build

npm install
npm run build

Test locally:

node dist/index.js add knowledge-base --pattern llm-wiki
node dist/index.js add knowledge-base --pattern graphify
node dist/index.js add sdd --dry-run

Project structure

src/
├── index.ts          # CLI entry point
├── skills/           # Generic skills (installed by init and add sdd)
│   ├── code-review/
│   ├── commit-msg/
│   ├── estimation/
│   ├── pr-description/
│   ├── requirement/
│   └── security-review/
├── patterns/         # Knowledge base pattern templates
│   ├── llm-wiki/
│   └── graphify/
└── sdd/              # SDD framework templates
    └── spec-kit/
        ├── skills/   # speckit-* slash command skills
        ├── claude/   # CLAUDE.md templates (greenfield + brownfield)
        └── specify/  # .specify/ tree (templates, workflows, scripts)

Adding a pattern

1. Create src/patterns/<name>/ with template files (at minimum CLAUDE.md and README.md)
2. Add <name> to KNOWLEDGE_PATTERNS in src/index.ts
3. Add scaffold logic in scaffoldKnowledge() for any extra dirs
4. Run npm run build

Adding an SDD framework

Create src/sdd/<framework-name>/ with the same structure as spec-kit/. It is auto-discovered.

Publishing

npm login
npm publish --access public

New version:

npm version patch   # or minor / major
npm publish --access public

Requirements

• Node.js 18+
• Claude Code
• Python 3.10+ (only for --pattern graphify)

License

MIT