{
  "markdown": "# 🚀 Software Development Standards\n\n![Anthropic Skills](https://img.shields.io/badge/Anthropic%20Skills-68.9%25%20Compliant-yellow)\n\n**Start any project right in 30 seconds. Based on industry best practices and NIST guidelines.**\n\n## Why This Repository?\n\nYou're starting a new project. You need to make dozens of decisions: project structure, testing approach, security patterns, CI/CD setup, documentation format. Each wrong choice costs days or weeks to fix later.\n\n**This repository gives you those answers immediately** - comprehensive, production-tested standards that work together as a complete system. No more arguing about code style. No more wondering about test coverage. No more security reviews finding basic issues.\n\nJust copy, implement, and ship.\n\n---\n\n## 🆕 Skills System (NEW!)\n\n**Last Updated**: 2025-10-24 21:45:00 EDT (UTC-04:00)\n\n**Load only what you need. Progressive loading reduces token usage by 91-99.6% depending on scenario:**\n\n- Repository metadata: 127K → 500 tokens (99.6% reduction)\n- Typical usage: 8.9K → 573 tokens (93.6% reduction)\n- Single skill Level 1: ~300-600 tokens\n\n**Evidence**: 61 active skills with progressive disclosure (Level 1: metadata, Level 2: instructions, Level 3: resources)\n\n### What Are Skills?\n\nInstead of loading massive 50,000+ token documents, use **progressive skills** that deliver the right information at the right time:\n\n**Note**: The `@load` directive is planned for v2.0. Current implementation uses the skill-loader script.\n\n**Current (v1.x):**\n\n```bash\n# Load Level 1: Quick Start (5 minutes, ~336 tokens)\npython3 scripts/skill-loader.py load skill:coding-standards\n\n# Load by product type (auto-selects relevant skills)\npython3 scripts/skill-loader.py load product:api --language python\n# Loads: coding-standards, security-practices, testing, nist-compliance\n\n# Total: ~1,755 tokens compared to loading all standards documents (~150K tokens) (98.8% reduction)\n```\n\n**Planned (v2.0):**\n\n```bash\n@load skill:coding-standards\n@load product:api --language python\n```\n\n### Quick Skills Tutorial (2 minutes)\n\n**Current (v1.x):**\n\n```bash\n# 1. Get skill recommendations for your project\npython3 scripts/skill-loader.py recommend ./\n\n# 2. Load recommended skills\npython3 scripts/skill-loader.py load product:api\n\n# 3. See the difference!\n# Before: ~150,000 tokens (full standards)\n# After: ~1,755 tokens (Level 1)\n```\n\n**Planned (v2.0):**\n\n```bash\n# 2. Load recommended skills\n@load product:api\n```\n\n### Available Skills (61 Total)\n\n**Skill Count Verified**: 2025-10-24 19:21:55 EDT (UTC-04:00)\n\n**Core Skills** (examples with estimated Level 1 token counts):\n\n- **coding-standards**: Code quality patterns (~300-400 tokens L1)\n- **security-practices**: Modern security (~400-500 tokens L1)\n- **testing**: TDD & testing strategies (~400-500 tokens L1)\n- **nist-compliance**: NIST 800-53r5 controls (~500-600 tokens L1)\n\nNote: Token counts are estimates. Actual counts vary based on skill complexity. See `skills/` directory for complete catalog.\n\n**[View Full Catalog →](./docs/SKILLS_CATALOG.md) | [Quick Start Guide →](./docs/guides/SKILLS_QUICK_START.md) | [Skills Directory →](./skills/README.md)**\n\n---\n\n## ⚡ Quick Start for New Projects\n\n**Copy these templates to your new repository and let AI do the rest:**\n\n### Option 1: Full Kickstart Template (Recommended)\n\n```bash\n# 1. Copy the kickstart template to your new repo\ncurl -o KICKSTART.md https://raw.githubusercontent.com/williamzujkowski/standards/master/templates/KICKSTART_REPO.md\n\n# 2. Fill in basic project details (or let AI auto-detect)\n\n# 3. Provide KICKSTART.md to any AI assistant (Claude, ChatGPT, Gemini)\n# AI will auto-detect your tech stack and generate:\n# - Complete project structure\n# - Standards-aligned code\n# - Configuration files\n# - CI/CD pipelines\n# - Testing setup\n# - Security implementation\n```\n\n### Option 2: Use LLM Prompt Directly\n\n1. **Copy this prompt**: [KICKSTART_PROMPT.md](./docs/guides/KICKSTART_PROMPT.md)\n2. **Paste into any LLM** (ChatGPT, Claude, Gemini, etc.) with your project description\n3. **Get instant analysis**:\n   - Complete project structure\n   - Relevant standards selection\n   - Implementation roadmap\n   - Tool configurations\n   - First PR ready to go\n\n**Example:**\n\n```\nYou: [Paste kickstart prompt] + \"I'm building a Python API with FastAPI and PostgreSQL\"\n\nAI: Here's your complete setup:\n- Project structure with /src, /tests, /docs\n- FastAPI best practices from CODING_STANDARDS.md\n- pytest configuration from TESTING_STANDARDS.md\n- PostgreSQL patterns from DATA_ENGINEERING_STANDARDS.md\n- Docker setup from CLOUD_NATIVE_STANDARDS.md\n- GitHub Actions from .github/workflows/\n[... complete implementation plan ...]\n```\n\n### What You Get\n\nThe AI assistant will generate a complete `PROJECT_PLAN.md` including:\n\n- **Auto-detected tech stack** from your repository\n- **Standards recommendations** using `@load` directives (v2.0 - planned) or skill-loader script (v1.x - current)\n- **Project structure** with full directory tree\n- **Configuration files** (pyproject.toml, package.json, etc.)\n- **CI/CD pipelines** with quality gates\n- **Security implementation** with NIST controls\n- **Testing strategy** with 80%+ coverage targets\n- **8-week implementation timeline** with phases\n\n### Common Scenarios\n\n**Note**: The `@load` directive examples below are planned for v2.0. Current implementation uses skill-loader script.\n\n**Python API (v2.0 - planned):**\n\n```bash\n@load [product:api + CS:python + TS:pytest + SEC:* + DE:database]\n```\n\n**Python API (v1.x - current):**\n\n```bash\npython3 scripts/skill-loader.py load product:api --language python\n```\n\n**React Web App (v2.0 - planned):**\n\n```bash\n@load [product:frontend-web + FE:react + SEC:auth + DOP:ci-cd]\n```\n\n**React Web App (v1.x - current):**\n\n```bash\npython3 scripts/skill-loader.py load product:frontend-web --framework react\n```\n\n**Mobile App (v2.0 - planned):**\n\n```bash\n@load [product:mobile + CS:swift + TS:xctest + SEC:mobile-auth]\n```\n\n**Mobile App (v1.x - current):**\n\n```bash\npython3 scripts/skill-loader.py load product:mobile\n```\n\n**Data Pipeline (v2.0 - planned):**\n\n```bash\n@load [product:data-pipeline + CS:python + DE:* + OBS:monitoring]\n```\n\n**Data Pipeline (v1.x - current):**\n\n```bash\npython3 scripts/skill-loader.py load product:data-pipeline --language python\n```\n\n---\n\n## 📋 Available Templates\n\n### Core Templates\n\n| Template | Purpose | Usage |\n|----------|---------|-------|\n| [KICKSTART_REPO.md](./templates/KICKSTART_REPO.md) | LLM-optimized repo kickstart | Copy to new repo, fill details, provide to AI |\n| [PROJECT_PLAN_TEMPLATE.md](./templates/PROJECT_PLAN_TEMPLATE.md) | Systematic project planning | AI generates this from kickstart |\n\n### Example Projects\n\n| Example | Tech Stack | Located In |\n|---------|-----------|------------|\n| Python API | FastAPI + PostgreSQL | [examples/project-templates/python-api/](./examples/project-templates/) |\n| React SPA | React + TypeScript | [examples/project-templates/react-spa/](./examples/project-templates/) |\n| NIST-compliant Service | Security controls | [examples/nist-templates/](./examples/nist-templates/) |\n\n---\n\n## 🔄 For Existing Projects\n\n```bash\n# Quick assessment\ncurl -O https://raw.githubusercontent.com/williamzujkowski/standards/master/scripts/setup-project.sh\nchmod +x setup-project.sh\n./setup-project.sh --assess my-project\n\n# Or manually:\n1. Review UNIFIED_STANDARDS.md for gaps\n2. Copy relevant templates from examples/\n3. Run validation: python scripts/generate-audit-reports.py\n```\n\n---\n\n## 📚 What You Get\n\n### Complete Standards Library (25 Documents)\n\n**Core Development**\n\n- [UNIFIED_STANDARDS.md](./docs/standards/UNIFIED_STANDARDS.md) - Master reference (start here)\n- [CODING_STANDARDS.md](./docs/standards/CODING_STANDARDS.md) - Language-specific patterns\n- [TESTING_STANDARDS.md](./docs/standards/TESTING_STANDARDS.md) - Test strategies & coverage\n- [MODERN_SECURITY_STANDARDS.md](./docs/standards/MODERN_SECURITY_STANDARDS.md) - Security implementation\n- [KNOWLEDGE_MANAGEMENT_STANDARDS.md](./docs/standards/KNOWLEDGE_MANAGEMENT_STANDARDS.md) - Documentation architecture\n\n**Specialized Domains**\n\n- Frontend, Mobile, Backend, Data Engineering\n- Cloud Native, DevOps, Observability\n- AI/ML, Event-Driven, Microservices\n- Cost Optimization, Legal Compliance\n\n### Ready-to-Use Templates\n\n```\nexamples/\n├── project-templates/     # Python, JS/TS, Go starter projects\n├── nist-templates/        # Security components with compliance tags\n├── docker/                # Container configurations\n└── ci-cd/                 # GitHub Actions workflows\n```\n\n### Automation & Tools\n\n- **Setup Scripts**: Auto-configure new projects\n- **Validation Tools**: Check standards compliance\n- **NIST Tagging**: Security control annotations\n- **VS Code Extension**: Real-time compliance hints\n- **Pre-commit Hooks**: Enforce standards automatically\n\n---\n\n## 🎯 For Different Roles\n\n### Developers\n\n- Copy working code patterns\n- Skip bikeshedding discussions\n- Focus on building features\n- Pass code reviews easily\n\n### Tech Leads\n\n- Onboard team members faster\n- Maintain consistency across projects\n- Reduce technical debt\n- Implement best practices systematically\n\n### Architects\n\n- Reference architecture patterns\n- Security-by-default designs\n- Scalability guidelines\n- Integration strategies\n\n### Compliance Teams\n\n- NIST 800-53r5 control templates\n- Audit-ready documentation\n- Automated compliance checking\n- Evidence collection tools\n\n---\n\n## 🔥 Real Examples\n\n### Start a Python API\n\n**Planned (v2.0):**\n\n```bash\n@load [product:api + CS:python + TS:pytest + SEC:auth]\n# Gets you: FastAPI structure, pytest config, JWT auth, Docker, CI/CD\n```\n\n**Current (v1.x):**\n\n```bash\npython3 scripts/skill-loader.py load product:api --language python\n# Gets you: FastAPI structure, pytest config, JWT auth, Docker, CI/CD\n```\n\n### Build a React App\n\n**Planned (v2.0):**\n\n```bash\n@load [product:frontend-web + FE:react + SEC:*]\n# Gets you: React patterns, testing, all security standards, deployment\n```\n\n**Current (v1.x):**\n\n```bash\npython3 scripts/skill-loader.py load product:frontend-web --framework react\n# Gets you: React patterns, testing, all security standards, deployment\n```\n\n### Data Pipeline\n\n**Planned (v2.0):**\n\n```bash\n@load [product:data-pipeline + DE:* + OBS:monitoring]\n# Gets you: ETL patterns, data quality, monitoring, orchestration\n```\n\n**Current (v1.x):**\n\n```bash\npython3 scripts/skill-loader.py load product:data-pipeline\n# Gets you: ETL patterns, data quality, monitoring, orchestration\n```\n\n---\n\n## 📁 Repository Structure\n\n```\nstandards/\n├── docs/\n│   ├── standards/          # 24 comprehensive standards\n│   ├── guides/             # Implementation guides\n│   └── nist/               # NIST compliance docs\n├── examples/               # Copy-paste templates\n├── scripts/                # Automation tools\n├── config/                 # Configuration files\n├── .github/workflows/      # CI/CD templates\n└── CLAUDE.md               # LLM interface & routing\n```\n\n---\n\n## ⚖️ Legal & License\n\nMIT License - Free for commercial use. Standards provided \"as-is\" without warranty. Legal compliance documents are templates, not legal advice. Always consult professionals for your specific needs.\n\n---\n\n## 🤝 Contributing\n\nWe actively welcome contributions! The standards evolve with real-world usage.\n\n- **Report issues** you encounter\n- **Submit PRs** with improvements\n- **Share templates** that work\n- **Add examples** from your projects\n\nSee [CREATING_STANDARDS_GUIDE.md](./docs/guides/CREATING_STANDARDS_GUIDE.md) for guidelines.\n\n### 📖 Documentation (MkDocs)\n\nThis repository uses [MkDocs](https://www.mkdocs.org/) with the [Material theme](https://squidfunk.github.io/mkdocs-material/) for documentation.\n\n**Local Development:**\n\n```bash\n# Install dependencies\npip install -r requirements.txt\n\n# Serve documentation locally (with live reload)\nmkdocs serve\n# Visit http://127.0.0.1:8000\n\n# Build static site\nmkdocs build\n\n# Build with strict mode (fails on warnings)\nmkdocs build --strict\n```\n\n**Features:**\n\n- Material theme with light/dark mode\n- Enhanced search functionality\n- Mobile-responsive navigation\n- Automatic deployment via GitHub Actions\n\nDocumentation automatically deploys to GitHub Pages when changes are pushed to the master branch.\n\n---\n\n## 🤖 Claude Code Integration\n\nMake all standards skills and agents globally available in Claude Code via auto-discovery.\n\n### Quick Install\n\n```bash\n# Run from standards repo root\n./scripts/sync-to-claude.sh\n\n# Verify installation\nls ~/.claude/skills/std-* | head -5\nls ~/.claude/agents/std-*.md | head -5\n```\n\n### What Gets Installed\n\n- **61 Skills**: Symlinked to `~/.claude/skills/std-*`\n- **60 Agents**: Symlinked to `~/.claude/agents/std-*.md`\n\nAll items prefixed with `std-` for easy identification and to avoid conflicts.\n\n### Uninstall\n\n```bash\n./scripts/sync-to-claude.sh --uninstall\n```\n\n---\n\n## 🚦 Quick Links\n\n**Get Started**\n\n- 🚀 [KICKSTART_PROMPT.md](./docs/guides/KICKSTART_PROMPT.md) - AI project analyzer\n- 📚 [UNIFIED_STANDARDS.md](./docs/standards/UNIFIED_STANDARDS.md) - Complete reference\n- ✅ [ADOPTION_CHECKLIST.md](./docs/guides/ADOPTION_CHECKLIST.md) - Implementation roadmap\n\n**Skills (NEW!)**\n\n- 🆕 [Skills Quick Start](./docs/guides/SKILLS_QUICK_START.md) - 5-minute tutorial\n- 📖 [Skills User Guide](./docs/guides/SKILLS_USER_GUIDE.md) - Complete guide\n- 📚 [Skills Catalog](./docs/SKILLS_CATALOG.md) - All available skills\n- 🔄 [Migration Guide](./archive/old-migrations/migration/MIGRATION_GUIDE.md) - Migrate to skills\n- ✍️ [Authoring Guide](./docs/guides/SKILL_AUTHORING_GUIDE.md) - Create skills\n- 🔌 [Claude Integration](./docs/guides/CLAUDE_INTEGRATION_GUIDE.md) - API & CLI integration\n- 📡 [API Documentation](./docs/api/SKILLS_API.md) - Programmatic API\n\n**Resources**\n\n- [Project Templates](./examples/project-templates/)\n- [Setup Script](./scripts/setup-project.sh)\n- [Standards Index](./docs/guides/STANDARDS_INDEX.md)\n- [Creating Standards Guide](./docs/guides/CREATING_STANDARDS_GUIDE.md)\n\n**Support**\n\n- [GitHub Issues](https://github.com/williamzujkowski/standards/issues)\n- [Discussions](https://github.com/williamzujkowski/standards/discussions)\n\n---\n\n*Stop debating. Start shipping. Your standards are here.*\n\n## Catalog (auto)\n\n<!-- AUTO-LINKS:badges/** -->\n\n- [standards-compliance-template](badges/standards-compliance-template.md)\n\n<!-- /AUTO-LINKS -->\n<!-- AUTO-LINKS:badges/**/*.md -->\n\n- [Readme](badges/README.md)\n- [Standards Compliance Template](badges/standards-compliance-template.md)\n\n<!-- /AUTO-LINKS -->\n",
  "bytes": 14573,
  "sha": "2d31673150dbb5224da24e7d0d73271eb544f3562406dff167fc48ca07b92251",
  "repo_slug": "williamzujkowski/standards",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_williamzujkowski_standards_data_nist_com_56d50e32/readme"
}