daffy0208__ai-dev-standards/docs/RESOURCE-GUIDE.md

Resource Guide

Last Updated: 2025-11-12 Version: 1.7.0 Status: ✅ 100% Discoverable

---

Purpose

Quick reference for all ai-dev-standards resources. Everything listed here is registered in meta/registry.json and validated by automated tests.

Archived: This replaces RESOURCE-INDEX.md, RESOURCE-DISCOVERY-ANALYSIS.md, RESOURCE-DISCOVERY-FIX-STATUS.md, and RESOURCE-PRIORITY-PLAN.md.

---

📊 Resource Inventory

Category	Count	Purpose	Auto-Update
Skills	64	AI methodologies (HOW to build)	✅ Yes
MCPs	50	Tools (DO things)	✅ Yes
Components	72	Reusable code patterns	📦 On-request
Integrations	28	Third-party service connectors	📦 On-request
Tools	24	Development tools	✅ Yes
Standards	20	Architecture patterns & best practices	✅ Yes
Playbooks	14	Step-by-step procedures	✅ Yes
Templates	19	Project starters	📦 On-request
Utils	8	Utility functions	📦 On-request
Schemas	4	Data validation schemas	✅ Yes
Examples	3	Sample code	📦 On-request
Installers	3	Setup automation scripts	✅ Yes
Scripts	Various	Build/maintenance scripts	✅ Yes

Core Resources (Tier 1): 238 resources (64 skills + 50 MCPs + 24 tools + 72 components + 28 integrations)

Supporting Resources (Tier 2): 122 resources (14 playbooks + 20 standards + 19 templates + 4 schemas + 8 utilities + 3 examples + 3 installers + 24 docs)

Total: 360 resources across all categories

---

🎯 Featured Resources

Top Skills

• mvp-builder — Rapid MVP development with P0/P1/P2 prioritization
• rag-implementer — RAG systems with vector databases
• product-strategist — Product-market fit validation
• frontend-builder — React/Next.js development
• api-designer — REST and GraphQL API design

[See complete skill list in meta/registry.json]

MCPs (Tools)

50 total MCP servers providing executable development tools including:

• brain-mcp — Intelligent skill discovery and orchestration
• accessibility-checker-mcp — WCAG compliance checking
• component-generator-mcp — React component generation with tests
• screenshot-testing-mcp — Visual regression testing
• knowledge-base-mcp — Knowledge base management (CRUD, versioning, validation)
• graph-database-mcp — Neo4j operations and Cypher queries
• vector-database-mcp — Vector database operations (Pinecone, Weaviate, Chroma)
• And 43 more specialized servers covering API design, security, performance, testing, deployment, and more

Coverage: 55 of 64 skills (85.9%) have MCP support with 119 skill-to-MCP relationships

Key Standards

• rag-pattern.md — RAG architecture
• microservices-pattern.md — Microservices design
• authentication-patterns.md — Auth patterns
• database-design-patterns.md — Database optimization
• serverless-pattern.md — Serverless architecture

[Complete list: 14 patterns in standards/]

---

🚀 Usage

Get Everything (Bootstrap)

npx @ai-dev-standards/bootstrap

Get Specific Resources

# Sync latest skills
ai-dev sync --skills

# Install a component
ai-dev install component rag-pipelines

# Get a template
ai-dev generate project --template saas-starter

Check What's Available

# List all resources
ai-dev list

# List by category
ai-dev list skills
ai-dev list mcps
ai-dev list components

---

📦 Resource Categories Explained

Skills (skills/)

What: Methodologies and approaches (the HOW) Example: rag-implementer explains how to build RAG systems Auto-update: ✅ Yes (always current) Customizable: No (canonical patterns)

MCPs (mcp-servers/)

What: Executable tools (the DO) Example: accessibility-checker runs WCAG audits Auto-update: ✅ Yes Customizable: Limited (configuration only)

Components (components/)

What: Reusable code templates Example: rag-pipelines provides RAG implementation code Auto-update: 📦 On-request Customizable: Yes (fully editable after install)

Integrations (integrations/)

What: Third-party service connectors Example: anthropic-client wraps Claude API Auto-update: 📦 On-request Customizable: Yes

Standards (standards/)

What: Architecture patterns and best practices Example: rag-pattern.md shows proven RAG architectures Auto-update: ✅ Yes (CRITICAL for security) Customizable: No (add custom docs separately)

Playbooks (playbooks/)

What: Step-by-step operational procedures Example: deployment-checklist.md lists pre-deploy steps Auto-update: ✅ Yes Customizable: No

Utils (utils/)

What: Helper functions and scripts Example: logger.ts provides formatted console output Auto-update: 📦 On-request Customizable: Yes

Templates (templates/)

What: Project starter kits Example: saas-starter provides full SaaS boilerplate Auto-update: 📦 On-request Customizable: Yes (starting point only)

Installers (installers/)

What: Automated setup scripts Example: create-rag-system sets up complete RAG stack Auto-update: ✅ Yes Customizable: No

---

🔍 Finding Resources

By Use Case

Building a RAG System?

• Skill: rag-implementer
• MCPs: vector-database-mcp (planned), embedding-generator-mcp (planned)
• Component: rag-pipelines
• Integration: vector-databases, llm-providers
• Standard: rag-pattern
• Installer: create-rag-system

Building an MVP?

• Skill: mvp-builder
• MCPs: feature-prioritizer-mcp (planned)
• Component: agents, workflows
• Playbook: validation-first-development

Building a SaaS App?

• Skills: frontend-builder, api-designer, deployment-advisor
• MCPs: component-generator, accessibility-checker
• Components: ui-components, forms, auth
• Installer: create-saas

By Technology

React/Next.js:

• frontend-builder skill
• component-generator MCP
• ui-components, forms components

AI/LLM:

• rag-implementer, multi-agent-architect skills
• anthropic-client integration

APIs:

• api-designer skill
• openapi-generator-mcp (planned)

---

✅ Quality Assurance

100% Registry Coverage

Every resource is registered in meta/registry.json and validated by:

• 30 automated tests (all passing)
• CI/CD enforcement (blocks merges if validation fails)
• Weekly manual review

Relationship Mapping

• 3/3 MCPs list which skills they enable
• 64/64 skills declare what they require
• 9/9 components list their dependencies
• 3/3 installers detail what they install

---

🚨 Known Gaps

MCP Coverage: 8%

• Current: 3 MCPs
• Needed: 30+ MCPs
• Gap: 92% of skills lack corresponding tools
• Status: Active development (see BUILD_FOCUS.md)

Skill Relationship Metadata: 50%

• Current: 64/64 skills have requires field
• Target: All high-priority skills
• Status: Phase 2 complete for priority skills

---

📚 Related Docs

• BUILD_FOCUS.md — Current development priorities
• AUDIT-SYSTEM.md — Quality validation procedures
• AUTO-SYNC-GUIDE.md — How resources stay up-to-date

---

🎯 Next Steps

1. For Users: Run npx @ai-dev-standards/bootstrap to get started
2. For Contributors: See CONTRIBUTING.md
3. For MCP Development: See BUILD_FOCUS.md (MCPs are current priority)

---

Version: 1.1.0 | Registry Coverage: 100% | Tests Passing: 30/30