Agentic Software Development Lifecycle (SDLC) Framework

TL;DR

Pass a target repository or engineering task into this Software Development Lifecycle (SDLC) vault, bootstrap kit, and sdlc-cli.py checker. The framework installs Git commit hooks, loads fifteen engineering principles, and outputs standardized repository templates, pull request checklists, and local baseline verification results.

Inputs, Checks, and Outputs

Stage	Input	Check or Action	Output
Load rules	Local checkout of this repository	Run python3 sdlc-cli.py load-principles	Prints principles/agentic-playbook/index.md to standard output
Verify local setup	Repository root directory	Run python3 sdlc-cli.py check	Verifies .husky/ hooks and .github/workflows/agent-principle-check.yml presence
Bootstrap a target repo	Existing Git repository	Run sdlc-bootstrap-kit/bootstrap-sdlc.sh	Installs husky hooks, commitlint, core templates, and the pull request workflow
Audit documentation	Scoped Markdown guides	Run /usr/bin/python3 -m unittest tests/test_doc_hygiene.py -v	Validates summary bounds, sentence length, acronym expansion, and relative links

Quick Start

# 1. Print the 15 core engineering principles for an agent session
python3 sdlc-cli.py load-principles

# 2. Check local Git hook and workflow configuration
python3 sdlc-cli.py check

# 3. Print the session bootstrap prompt template
cat 40-templates/agent-bootstrap-prompt.md

# 4. Run the zero-dependency documentation hygiene gate
/usr/bin/python3 -m unittest tests/test_doc_hygiene.py -v

How Agents and Operators Use This Repository

1. Read the operating contract first: Start every session with AGENTS.md, AGENT-GUIDE.md, and principles/agentic-playbook/index.md.
2. Select the smallest matching workflow: Read agentic-sdlc-blueprint.md for the seven-layer pipeline from architecture and task scoping through pull requests, Continuous Integration (CI), review, and deployment.
3. Copy templates or starter skeletons: Pull individual checklists from 40-templates/ or full repository skeletons from 55-starter-kits/ rather than inventing ad-hoc process rules.
4. Enforce independent verification: Run local checks before committing, open scoped pull requests, and never allow an agent to approve its own changes.

Repository Map

• AGENTS.md — Concise operating contract and verification gate for coding agents.
• AGENT-GUIDE.md — Operational rules for navigating and extending this repository.
• principles/agentic-playbook/index.md — Index of the 15 standalone engineering principle sheets.
• agentic-sdlc-blueprint.md — Seven-layer workflow overview, golden path, and reading paths.
• 00-index/ — Navigation maps for layers (10-layers/), reference notes (20-reference/), patterns (30-patterns/), variants (35-variants/), templates (40-templates/), playbooks (45-playbooks/), worked examples (50-examples/), and starter kits (55-starter-kits/).
• sdlc-bootstrap-kit/README.md — Shell harness for installing framework files and Git hooks into another repository.
• CONTEXT.md — Directory and file inventory for quick orientation.
• CONTRIBUTING.md — Contribution workflow for human operators and autonomous agents.