SDLC Framework

Software development workflows

SDLC Complete Framework - Quick Start

Build software with AI-assisted lifecycle management: Inception → Elaboration → Construction → Transition.


Install & Deploy

Native Claude Code integration - no npm required:

# Add AIWG marketplace (one-time)
/plugin marketplace add jmagly/ai-writing-guide

# Install SDLC framework
/plugin install sdlc@aiwg        # Full SDLC framework
/plugin install utils@aiwg       # Core utilities (recommended)

No account required - Plugin distribution is decentralized. No registry signup, no approval process.

Option B: npm + CLI (Multi-Platform)

For CLI tools and deploying to other platforms:

npm install -g aiwg

Deploy to your project:

cd /path/to/your/project

# New project? Scaffold first:
aiwg -new

# Then deploy framework:
aiwg use sdlc

After Installation

1. Open in your AI platform

claude .                   # Claude Code
cursor .                   # Cursor
droid .                    # Factory AI

2. Wire the context to your project (existing projects)

`aiwg use` already wrote the project context (`CLAUDE.md` + `AIWG.md`), so natural-language command mapping ("run security review" → workflow) works right away via AIWG's Discover-First protocol. On an existing project, or to pull in the latest AIWG, run this once in the tool to re-tailor that context to your codebase and preserve any edits you've made (optional on a brand-new project):

/aiwg-regenerate

See the Regenerate Guide for details.

3. You're ready. See the Intake Guide for starting projects.


Artifacts Location

All documents generated in `.aiwg/`:

.aiwg/
├── intake/        # Project definition
├── requirements/  # User stories, use cases
├── architecture/  # SAD, ADRs
├── testing/       # Test plans, results
├── security/      # Threat models
└── deployment/    # Runbooks

Voice Profiles for Documentation

For consistent voice across your SDLC documentation:

aiwg use writing           # Add Voice Framework

Built-in profiles: `technical-authority`, `friendly-explainer`, `executive-brief`, `casual-conversational`


Iterative Task Execution with Al

For tasks that need multiple attempts or long-running operations:

# Fix all failing tests (internal loop)
/ralph "Fix all failing tests" --completion "npm test passes"

# Long-running migration with crash recovery (external loop)
/ralph-external "Migrate to TypeScript" --completion "npx tsc --noEmit exits 0"

See the Al Guide for detailed documentation.


What's Next?