matteocervelli/llms

Centralized LLM configuration and documentation management system. Tools for building skills, commands, agents, prompts, and managing MCP servers. Multi-LLM support (Claude Code, Codex, OpenCode).

License:MITLanguage:Python161

Deep Analysis

้›†ไธญๅผๅคšLLM้…็ฝฎ็ฎก็†็ณป็ปŸ๏ผŒๆไพ›14ไธชไธ“ไธšAgentๅ’Œ37ไธชๆŠ€่ƒฝ็š„่‡ชๅŠจๅŒ–่ฝฏไปถๅผ€ๅ‘ๅทฅไฝœๆต

Core Features

Technical Implementation

Highlights
  • ไผไธš็บงๅคšAgent็ผ–ๆŽ’็ณป็ปŸ่ฎพ่ฎก
  • ๅฎŒๆ•ด็š„TDDๅผ€ๅ‘ๅทฅไฝœๆต
  • 80%ๆต‹่ฏ•่ฆ†็›–็އ+OWASPๅฎ‰ๅ…จๆ‰ซๆ+WCAG 2.1 AAๅฏ่ฎฟ้—ฎๆ€งๆ ‡ๅ‡†
  • ๆธ่ฟ›ๅผไธŠไธ‹ๆ–‡ๅŠ ่ฝฝๆ้ซ˜ๆ•ˆ็އ
  • ่‡ชๅŠจไปŽGitHub Issue็”ŸๆˆๅŠŸ่ƒฝๅนถๅˆ›ๅปบPR
  • ้…็ฝฎไผ˜ๅ…ˆ็บง็ปงๆ‰ฟๆœบๅˆถ๏ผˆLocal>Project>Global๏ผ‰
Use Cases
  • ้œ€่ฆๆ ‡ๅ‡†ๅŒ–LLMๅผ€ๅ‘ๅทฅไฝœๆต็š„ๅ›ข้˜Ÿ
  • ๅคš้กน็›ฎๅคšLLM้…็ฝฎ็ปŸไธ€็ฎก็†
  • ่‡ชๅŠจๅŒ–่ฝฏไปถๅผ€ๅ‘ๆตๆฐด็บฟ๏ผˆไปŽIssueๅˆฐPR๏ผ‰
  • ้œ€่ฆไธฅๆ ผไปฃ็ ่ดจ้‡ๅ’Œๅฎ‰ๅ…จๆ ‡ๅ‡†็š„้กน็›ฎ
  • ๆž„ๅปบๅ’Œๅˆ†ๅ‘Claude CodeๆŠ€่ƒฝ/ๅ‘ฝไปค/ๆ’ไปถ
Limitations
  • ๆžถๆž„ๅคๆ‚ๅบฆ้ซ˜๏ผŒๅญฆไน ๆ›ฒ็บฟ้™กๅณญ
  • ้œ€่ฆๅคšไธชLLMๆจกๅž‹๏ผˆOpus/Sonnet/Haiku๏ผ‰ๆˆๆœฌ่พƒ้ซ˜
  • ๅคšLLMๆ”ฏๆŒ๏ผˆCodex/OpenCode๏ผ‰ไปๅœจ่ง„ๅˆ’ไธญ
  • ไพ่ต–็‰นๅฎšMCPๆœๅŠกๅ™จ๏ผˆcontext7/playwright๏ผ‰
  • ไป…16 stars็คพๅŒบ่ง„ๆจก่พƒๅฐ
Tech Stack
Python 3.11+uvpytestBlackFlake8Mypycrawl4ai

LLMs - Configuration Management System

Centralized LLM configuration and documentation management system. Tools for building skills, commands, agents, prompts, and managing MCP servers. Multi-LLM support (Claude Code, Codex, OpenCode).

License: MIT
Python 3.11+


๐ŸŽฏ Vision

Build a unified system for managing LLM configurations, documentation, and tooling across multiple LLM providers (Claude Code, Codex, OpenCode, etc.). Enable developers to:

  • Fetch and maintain up-to-date documentation from LLM providers
  • Build and manage skills, commands, agents, and prompts
  • Package and distribute plugins for team sharing
  • Manage MCPs (Model Context Protocol servers)
  • Work across LLMs with a single toolset

โœจ Features

Current (Sprint 1-4: Claude Code Focus)

  • โœ… Documentation Fetcher: Automatically fetch and update docs from Anthropic, OpenAI, etc.
  • โœ… Scope Intelligence: Auto-detect global/project/local configurations
  • โœ… Skill Builder: Generate Claude Code skills with templates
  • โœ… Command Builder: Create slash commands for automation
  • โœ… Agent Builder: Build sub-agents for specialized tasks
  • โœ… Prompt Builder: Generate and validate master prompts
  • โœ… Plugin Builder: Package skills/commands/agents for distribution
  • โœ… MCP Manager: Manage Model Context Protocol servers
  • โœ… Hook Builder: Create hook configurations

Future (Sprint 5+: Multi-LLM)

  • ๐Ÿ”ฎ Codex Support: Adapt tools for OpenAI Codex
  • ๐Ÿ”ฎ OpenCode Support: Extend to OpenCode
  • ๐Ÿ”ฎ Universal Format: LLM-agnostic configuration format
  • ๐Ÿ”ฎ RAG Integration: Personal documentation knowledge base

๐Ÿค– Feature-Implementer v2 Architecture

Status: โœ… Production Ready (v1.0.0)

The Feature-Implementer v2 is a sophisticated multi-agent system that orchestrates the complete software development lifecycle from requirements analysis to deployment. Built with 14 specialized agents, 37 production skills, and intelligent hooks, it provides a structured, automated approach to implementing features from GitHub issues.

Architecture Overview

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              FEATURE-IMPLEMENTER (Main Agent)               โ”‚
โ”‚                  6-Phase Orchestration                      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚                                       โ”‚
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”                        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚   PHASE 1   โ”‚                        โ”‚   PHASE 2   โ”‚
    โ”‚  ANALYSIS   โ”‚                        โ”‚   DESIGN    โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜                        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚                                       โ”‚
    @analysis-specialist               @design-orchestrator
    โ”œโ”€ requirements-extractor           โ”œโ”€ @architecture-designer
    โ”œโ”€ security-assessor                โ”‚  โ”œโ”€ architecture-planner
    โ””โ”€ tech-stack-evaluator             โ”‚  โ”œโ”€ data-modeler
                                         โ”‚  โ””โ”€ api-designer
                                         โ”œโ”€ @documentation-researcher
                                         โ”‚  โ”œโ”€ doc-fetcher
                                         โ”‚  โ””โ”€ doc-analyzer
                                         โ””โ”€ @dependency-manager
                                            โ”œโ”€ dependency-analyzer
                                            โ””โ”€ version-checker

    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚ PHASE 3-4   โ”‚    โ”‚  PHASE 5         โ”‚    โ”‚  PHASE 6    โ”‚
    โ”‚ APPROVAL &  โ”‚    โ”‚  VALIDATION      โ”‚    โ”‚  DEPLOYMENT โ”‚
    โ”‚ IMPLEMENT   โ”‚    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜               โ”‚                    โ”‚
    feature-implementer    @validation-orchestrator    @deployment-specialist
    โ”œโ”€ analysis-skill     โ”œโ”€ @unit-test-specialist    โ”œโ”€ documentation-updater
    โ”œโ”€ design-skill       โ”œโ”€ @integration-test        โ”œโ”€ changelog-generator
    โ””โ”€ implementation     โ”œโ”€ @test-runner             โ””โ”€ pr-creator
       - TDD approach     โ”œโ”€ @code-quality
       - Code review      โ”œโ”€ @security-specialist
       - Best practices   โ””โ”€ @e2e-accessibility (frontend)

Six-Phase Workflow

  1. Phase 1: Requirements Analysis (@analysis-specialist)

    • Extract requirements from GitHub issues
    • Security assessment (OWASP, data privacy)
    • Tech stack evaluation
    • Output: docs/implementation/analysis/analysis.md
  2. Phase 2: Architecture & Design (@design-orchestrator)

    • Parallel sub-agents:
      • Architecture design (components, data models, APIs)
      • Documentation research (fetch latest library docs)
      • Dependency management (compatibility, versions)
    • Design synthesis and validation
    • Output: docs/implementation/prp/prp.md (Problem-Requirements-Plan)
  3. Phase 3: User Approval

    • Present analysis and design to user
    • Gather feedback and approval
    • Iterate if needed
  4. Phase 4: Implementation (Main agent)

    • Test-Driven Development (TDD)
    • Code according to project standards
    • Follow best practices and patterns
    • Maintain โ‰ค500 lines per file
    • Output: Working code with initial tests
  5. Phase 5: Validation (@validation-orchestrator)

    • Sequential specialists (with recursive communication):
      • Unit tests (@unit-test-specialist)
      • Integration tests (@integration-test-specialist)
      • Test execution & coverage (@test-runner-specialist)
      • Code quality checks (@code-quality-specialist)
      • Security scanning (@security-specialist)
      • E2E & accessibility testing (@e2e-accessibility-specialist, frontend only)
    • Recursive loop if validation fails
    • Output: Validation reports, test results, security scan
  6. Phase 6: Deployment (@deployment-specialist)

    • Update documentation (README, guides, API docs)
    • Generate CHANGELOG entry
    • Create pull request
    • Output: PR ready for review

All 14 Agents

Agent Role Model Auto-Activated Skills
feature-implementer Main orchestrator Sonnet analysis, design, implementation, validation
analysis-specialist Requirements analysis Haiku requirements-extractor, security-assessor, tech-stack-evaluator
design-orchestrator Design coordination Sonnet design-synthesizer, prp-generator
architecture-designer Component architecture Opus + ultrathink architecture-planner, data-modeler, api-designer
documentation-researcher Library docs Haiku + context7 doc-fetcher, doc-analyzer
dependency-manager Dependency analysis Haiku dependency-analyzer, version-checker
validation-orchestrator Validation coordination Sonnet validation-coordinator, recursive-communicator
unit-test-specialist Unit testing Haiku unit-test-writer, pytest-generator, jest-generator
integration-test-specialist Integration testing Haiku integration-test-writer, api-test-generator
test-runner-specialist Test execution Haiku test-executor, coverage-analyzer
code-quality-specialist Linting & formatting Haiku python-quality-checker, typescript-quality-checker, rust-quality-checker
security-specialist Security scanning Sonnet security-scanner, vulnerability-assessor, owasp-checker
e2e-accessibility-specialist E2E & WCAG 2.1 AA Sonnet + playwright e2e-test-writer, accessibility-checker
deployment-specialist Documentation & PR Haiku documentation-updater, changelog-generator, pr-creator

Production Skills (37)

Core Workflow Skills (4):

  • analysis/ - Requirements analysis guidance
  • design/ - Architecture and API design
  • implementation/ - TDD implementation with code standards
  • validation/ - Quality validation workflow

Specialized Skills (33) mapped to agents:

  • Analysis: requirements-extractor, security-assessor, tech-stack-evaluator
  • Design: design-synthesizer, prp-generator, architecture-planner, data-modeler, api-designer
  • Documentation: doc-fetcher, doc-analyzer
  • Dependencies: dependency-analyzer, version-checker
  • Validation: validation-coordinator, recursive-communicator
  • Testing: unit-test-writer, pytest-generator, jest-generator, integration-test-writer, api-test-generator, test-executor, coverage-analyzer
  • Quality: python-quality-checker, typescript-quality-checker, rust-quality-checker
  • Security: security-scanner, vulnerability-assessor, owasp-checker
  • E2E: e2e-test-writer, accessibility-checker
  • Deployment: documentation-updater, changelog-generator, pr-creator
  • On-demand: code-reviewer, test-generator

Hooks Configuration

Pre-commit Hook (.claude/hooks/pre-commit.py):

  • Triggers on git commit commands
  • Runs: Black โ†’ Flake8 โ†’ Mypy โ†’ Pytest
  • Blocking: Exit code 2 prevents commits if checks fail
  • 180-second timeout

Post-implementation Hook (.claude/hooks/post-implementation.py):

  • Triggers on implementation phase completion
  • Detects completion markers in transcript
  • Auto-triggers validation workflow
  • Non-blocking: Continues normal conversation flow
  • 60-second timeout

Usage

# Implement a feature from GitHub issue
@feature-implementer implement issue #123

# The agent will:
# 1. Analyze requirements (Phase 1)
# 2. Design architecture (Phase 2)
# 3. Present design for approval (Phase 3)
# 4. Implement with TDD (Phase 4)
# 5. Validate with specialists (Phase 5)
# 6. Create PR and update docs (Phase 6)

Quality Standards

  • Test Coverage: โ‰ฅ80% required
  • Code Quality: Black, Flake8, Mypy must pass
  • Security: OWASP Top 10 compliance
  • File Size: โ‰ค500 lines per file
  • Accessibility: WCAG 2.1 AA (f