repo-docslisted
Install: claude install-skill OneDro1d/dark-factory
# Repository Documentation Generator
Generate high-quality, consistent documentation following team standards.
## Overview
Creates documentation that follows the tiered document requirements, uses proper status indicators, includes visual diagrams, and maintains cross-references between documents.
## Document Tiers
### Tier 1: Essential (All Projects)
| Document | Purpose | Location |
|----------|---------|----------|
| **CLAUDE.md** | AI assistant context for codebase | Root |
| **README.md** | Project overview, quick start | Root |
| **ARCHITECTURE.md** | System architecture with diagrams | `docs/` |
| **DESIGN_DECISIONS.md** | Technical rationale, axioms | `docs/` |
### Tier 2: Operational (Deployed Systems)
| Document | Purpose | Location |
|----------|---------|----------|
| **DEPLOYMENT-[ENV].md** | Environment-specific deployment | `docs/` |
| **MONITORING.md** | Observability, metrics, alerting | `docs/` |
| **RELIABILITY.md** | Fault tolerance, SLAs, recovery | `docs/` |
| **TESTING-STRATEGY.md** | Testing approaches, coverage | `docs/` |
### Tier 3: Supporting (As Needed)
| Document | Purpose | Location |
|----------|---------|----------|
| **AI_ONBOARDING.md** | AI assistant quick start | Root |
| **GITOPS-STRATEGY.md** | CI/CD, automation | `docs/` |
| **[TOPIC]-GUIDE.md** | Deep-dives on topics | `docs/` |
| **diagrams/README.md** | Diagram rendering | `docs/diagrams/` |
## Universal Document Structure
Every document MUST begin with:
```markdown
# Do