claude-autopm 2.8.9 → 2.11.1

package/autopm/.claude/agents-compressed-example.md

@@ -0,0 +1,218 @@
+# Agent Descriptions - Compressed Format Example
+
+This file shows how agent descriptions can be compressed using XML and pipe-separated lists.
+
+## Traditional Format (Long)
+
+**Before Optimization:**
+
+```markdown
+### python-backend-engineer
+
+Use this agent for Python backend development including FastAPI, Django, Flask, and other Python frameworks.
+Specializes in REST APIs, GraphQL, microservices, asynchronous programming, and database integration.
+Expert in Python performance optimization, testing with pytest, and production deployment.
+
+**When to use:**
+- Building REST APIs with FastAPI
+- Creating GraphQL endpoints
+- Developing microservices
+- Database integration with SQLAlchemy
+- Async programming with asyncio
+- Testing with pytest
+
+**Documentation Queries:**
+- `mcp://context7/fastapi/routing` - FastAPI routing and endpoints
+- `mcp://context7/sqlalchemy/orm` - SQLAlchemy ORM patterns
+- `mcp://context7/pytest/fixtures` - Pytest testing patterns
+
+**Examples:**
+- "Build a FastAPI authentication endpoint with JWT"
+- "Create a microservice for user management"
+- "Optimize database queries with SQLAlchemy"
+```
+
+**Token Count:** ~200 tokens
+
+## Compressed Format (Short)
+
+**After Optimization:**
+
+```markdown
+<agent id="python-backend-engineer">
+<expertise>FastAPI|Django|Flask|REST|GraphQL|microservices|async|SQLAlchemy|pytest</expertise>
+<use_for>REST APIs|GraphQL|microservices|DB integration|async|testing|optimization</use_for>
+<context7>
+fastapi/routing|sqlalchemy/orm|pytest/fixtures
+</context7>
+<examples>
+FastAPI auth with JWT|User management microservice|SQLAlchemy query optimization
+</examples>
+</agent>
+```
+
+**Token Count:** ~60 tokens
+**Savings:** 70%
+
+## Multiple Agents - Compressed
+
+```markdown
+<agents>
+
+<agent id="python-backend-engineer">
+<exp>FastAPI|Django|Flask|REST|GraphQL|async|SQLAlchemy|pytest</exp>
+<ctx7>fastapi/routing|sqlalchemy/orm|pytest/fixtures</ctx7>
+</agent>
+
+<agent id="react-frontend-engineer">
+<exp>React|Next.js|TypeScript|hooks|state|routing|SSR|components</exp>
+<ctx7>react/hooks|nextjs/routing|typescript/react</ctx7>
+</agent>
+
+<agent id="postgresql-expert">
+<exp>PostgreSQL|indexing|optimization|partitioning|replication|JSON|full-text</exp>
+<ctx7>postgresql/performance|postgresql/indexing|postgresql/jsonb</ctx7>
+</agent>
+
+<agent id="kubernetes-orchestrator">
+<exp>K8s|Helm|deployments|services|ingress|operators|GitOps</exp>
+<ctx7>kubernetes/deployments|kubernetes/services|helm/charts</ctx7>
+</agent>
+
+<agent id="code-analyzer">
+<exp>Bug hunting|logic tracing|security analysis|performance|refactoring</exp>
+<use>Review code|Find bugs|Trace logic|Security scan|Optimize</use>
+</agent>
+
+<agent id="test-runner">
+<exp>Test execution|Jest|pytest|Playwright|analysis|reporting</exp>
+<use>Run tests|Analyze results|Generate reports|Debug failures</use>
+</agent>
+
+</agents>
+```
+
+## Full Compressed Agent Registry Format
+
+For the CLAUDE.md Active Agents section:
+
+```markdown
+<!-- AGENTS_START -->
+<agents_list>
+<core>
+agent-manager|code-analyzer|file-analyzer|test-runner|parallel-worker
+</core>
+
+<lang>
+bash-scripting-expert|javascript-frontend-engineer|nodejs-backend-engineer|python-backend-engineer
+</lang>
+
+<frameworks>
+react-frontend-engineer|react-ui-expert
+</frameworks>
+
+<testing>
+e2e-test-engineer|frontend-testing-engineer
+</testing>
+
+<cloud>
+aws-cloud-architect|azure-cloud-architect|gcp-cloud-architect
+</cloud>
+
+<devops>
+docker-containerization-expert|github-operations-specialist|kubernetes-orchestrator
+</devops>
+
+<db>
+bigquery-expert|cosmosdb-expert|mongodb-expert|postgresql-expert|redis-expert
+</db>
+
+<data>
+airflow-orchestration-expert|kedro-pipeline-expert
+</data>
+
+<messaging>
+message-queue-engineer|nats-messaging-expert
+</messaging>
+
+<integration>
+azure-devops-specialist|gemini-api-expert|openai-python-expert
+</integration>
+
+<infra>
+gcp-cloud-functions-engineer|terraform-infrastructure-expert|traefik-proxy-expert
+</infra>
+
+<monitoring>
+observability-engineer
+</monitoring>
+
+<security>
+ssh-operations-expert
+</security>
+
+<design>
+tailwindcss-expert|ux-design-expert
+</design>
+
+<workflow>
+langgraph-workflow-expert
+</workflow>
+
+<mgmt>
+agent-manager|mcp-context-manager|mcp-manager
+</mgmt>
+
+📖 Full registry: .claude/agents/AGENT-REGISTRY.md
+📖 Quick ref: .claude/quick-ref/agent-quick-ref.md
+</agents_list>
+<!-- AGENTS_END -->
+```
+
+**Traditional Format:** ~8,000 tokens (listing all 45+ agents with descriptions)
+**Compressed Format:** ~500 tokens (pipe-separated categorized list)
+**Savings:** 93.75%
+
+## Benefits of Compressed Format
+
+1. **Token Efficiency**: 70-93% reduction in tokens
+2. **Quick Scanning**: Pipe-separated lists easier to scan
+3. **Category Grouping**: XML tags organize by purpose
+4. **Lazy Loading**: Full docs loaded on-demand
+5. **Maintainability**: Simpler to update and maintain
+
+## Usage Pattern
+
+In CLAUDE.md optimized template:
+
+```markdown
+## 🤖 ACTIVE AGENTS (Compressed)
+
+<!-- AGENTS_START -->
+<agents_list>
+Core: agent-manager|code-analyzer|file-analyzer|test-runner
+Languages: bash-scripting-expert|javascript-frontend-engineer|python-backend-engineer
+...
+📖 Full registry: .claude/agents/AGENT-REGISTRY.md
+</agents_list>
+<!-- AGENTS_END -->
+```
+
+When agent is invoked:
+1. User: `@python-backend-engineer build API`
+2. Claude sees compressed listing
+3. Lazy loads: `.claude/agents/languages/python-backend-engineer.md`
+4. Queries Context7: `mcp://context7/fastapi/routing`
+5. Implements using full knowledge
+
+## Implementation Strategy
+
+1. **Keep full agent files** in `.claude/agents/` directories
+2. **Use compressed format** in CLAUDE.md for listing
+3. **Lazy load** full agent description when invoked
+4. **Query Context7** as required by agent's Documentation Queries section
+
+This provides best of both worlds:
+- Minimal tokens in initial context
+- Full agent knowledge when needed
+- Always-current documentation via Context7

package/autopm/.claude/quick-ref/agent-quick-ref.md

@@ -0,0 +1,153 @@
+# Agent Quick Reference
+
+<agent_categories>
+
+<core>
+@agent-manager - Create|analyze|manage agents
+@code-analyzer - Bug hunting|logic tracing|security analysis
+@file-analyzer - File|log analysis|context reduction
+@test-runner - Test execution|analysis|structured reports
+@parallel-worker - Multi-stream parallel execution
+</core>
+
+<languages>
+@bash-scripting-expert - Shell automation|scripts|POSIX
+@javascript-frontend-engineer - Vanilla JS|TypeScript|browser APIs
+@nodejs-backend-engineer - Node.js|Express|NestJS|Fastify
+@python-backend-engineer - FastAPI|Django|Flask|async
+</languages>
+
+<frameworks>
+@react-frontend-engineer - React|Next.js|component development
+@react-ui-expert - React UI frameworks|design systems
+</frameworks>
+
+<testing>
+@e2e-test-engineer - Playwright|Cypress|visual testing
+@frontend-testing-engineer - Jest|Vitest|React Testing Library
+</testing>
+
+<cloud>
+@aws-cloud-architect - AWS services|CloudFormation
+@azure-cloud-architect - Azure services|ARM|Bicep
+@gcp-cloud-architect - GCP services|Deployment Manager
+</cloud>
+
+<devops>
+@docker-containerization-expert - Dockerfile|Compose|multi-stage
+@github-operations-specialist - GitHub Actions|workflows|releases
+@kubernetes-orchestrator - K8s|Helm|deployments|operators
+</devops>
+
+<databases>
+@bigquery-expert - BigQuery|SQL|analytics|partitioning
+@cosmosdb-expert - Cosmos DB|multi-region|consistency
+@mongodb-expert - MongoDB|aggregation|sharding
+@postgresql-expert - PostgreSQL|optimization|indexing
+@redis-expert - Redis|caching|pub/sub|distributed locks
+</databases>
+
+<data>
+@airflow-orchestration-expert - Airflow|DAGs|task dependencies
+@kedro-pipeline-expert - Kedro|data pipelines|MLOps
+</data>
+
+<messaging>
+@message-queue-engineer - Kafka|RabbitMQ|SQS|event streaming
+@nats-messaging-expert - NATS|JetStream|clustering
+</messaging>
+
+<integration>
+@azure-devops-specialist - Azure DevOps|work items|pipelines
+@gemini-api-expert - Google Gemini|multimodal|function calling
+@openai-python-expert - OpenAI|GPT|embeddings|assistants
+</integration>
+
+<infrastructure>
+@gcp-cloud-functions-engineer - Cloud Functions|serverless
+@terraform-infrastructure-expert - Terraform|IaC|modules
+@traefik-proxy-expert - Traefik|reverse proxy|SSL
+</infrastructure>
+
+<monitoring>
+@observability-engineer - Prometheus|Grafana|ELK|Jaeger|APM
+</monitoring>
+
+<security>
+@ssh-operations-expert - SSH|key management|tunneling
+</security>
+
+<design>
+@tailwindcss-expert - TailwindCSS|utility-first|design systems
+@ux-design-expert - UX/UI|accessibility|user experience
+</design>
+
+<workflow>
+@langgraph-workflow-expert - LangGraph|state machines|AI workflows
+</workflow>
+
+<management>
+@mcp-context-manager - MCP servers|context optimization
+@mcp-manager - MCP installation|lifecycle|configuration
+</management>
+
+</agent_categories>
+
+<usage_patterns>
+
+<pattern name="Task Delegation">
+<rule>Use specialized agents for ALL non-trivial tasks</rule>
+<example>
+Task: Build FastAPI authentication
+Agent: @python-backend-engineer
+Context7: mcp://context7/fastapi/security
+</example>
+</pattern>
+
+<pattern name="Context Preservation">
+<rule>Agent responses ≤ 20% of input data</rule>
+<when>
+Large files → @file-analyzer
+Deep analysis → @code-analyzer
+Test execution → @test-runner
+</when>
+</pattern>
+
+<pattern name="Parallel Execution">
+<rule>Use @parallel-worker for independent work streams</rule>
+<example>
+@parallel-worker execute:
+- Stream 1: Frontend changes
+- Stream 2: Backend changes
+- Stream 3: Database migrations
+</example>
+</pattern>
+
+<pattern name="Specialist Selection">
+<decision_tree>
+Python code? → @python-backend-engineer
+React UI? → @react-frontend-engineer
+Database? → @[db-type]-expert
+Cloud? → @[cloud]-cloud-architect
+Tests? → @test-runner
+Logs? → @file-analyzer
+Bugs? → @code-analyzer
+</decision_tree>
+</pattern>
+
+</usage_patterns>
+
+<obligations>
+✓ ALWAYS use agents for non-trivial tasks
+✓ Check agent registry before implementing
+✓ Delegate to preserve context
+✓ Use parallel execution when possible
+✓ Follow agent recommendations
+</obligations>
+
+<full_docs>
+.claude/agents/AGENT-REGISTRY.md - Complete agent list
+.claude/rules/agent-mandatory.md - Usage enforcement
+.claude/rules/context-optimization.md - Context patterns
+.claude/rules/agent-coordination.md - Multi-agent workflows
+</full_docs>

package/autopm/.claude/quick-ref/common-patterns.md

@@ -0,0 +1,215 @@
+# Common Development Patterns (Quick Reference)
+
+<pattern_library>
+
+<pattern id="error-handling">
+<name>Fail-Fast Error Handling</name>
+<when>Critical configuration|Invalid input|System requirements</when>
+<code>
+# Python
+if not config.get('required_field'):
+    raise ValueError("Missing required_field")
+
+# TypeScript
+if (!config.requiredField) {
+    throw new Error('Missing requiredField');
+}
+</code>
+<principle>Fail early|Clear messages|No silent failures</principle>
+</pattern>
+
+<pattern id="search-before-create">
+<name>Search Before Creating</name>
+<when>New files|New functions|New components</when>
+<workflow>
+1. @code-analyzer search for similar code
+2. Grep for related patterns
+3. Read existing implementations
+4. Reuse or extend existing code
+5. Only create if truly new
+</workflow>
+<why>Prevent duplication|Maintain consistency|Reduce complexity</why>
+</pattern>
+
+<pattern id="agent-delegation">
+<name>Specialized Agent Delegation</name>
+<when>Complex tasks|Domain expertise needed|Context optimization</when>
+<mapping>
+Python backend → @python-backend-engineer
+React UI → @react-frontend-engineer
+Database → @postgresql-expert|@mongodb-expert
+Testing → @test-runner
+Analysis → @code-analyzer
+Logs → @file-analyzer
+</mapping>
+<benefit>Context preservation|Expert knowledge|Parallel work</benefit>
+</pattern>
+
+<pattern id="tdd-cycle">
+<name>Test-Driven Development</name>
+<steps>
+🔴 RED: Write failing test
+✅ GREEN: Minimal code to pass
+♻️ REFACTOR: Clean up code
+</steps>
+<commits>
+test: add failing test for [feature]
+feat: implement [feature]
+refactor: improve [feature] structure
+</commits>
+<ref>.claude/quick-ref/tdd-cycle.md</ref>
+</pattern>
+
+<pattern id="context7-first">
+<name>Documentation-First Development</name>
+<workflow>
+1. Query Context7 for current docs
+2. Review API signatures + patterns
+3. Implement using verified approach
+4. Test against documentation examples
+</workflow>
+<ref>.claude/quick-ref/context7-queries.md</ref>
+</pattern>
+
+<pattern id="git-workflow">
+<name>Branch-Based Git Workflow</name>
+<flow>
+main (protected)
+  └─ feature/name
+       ├─ commit: test
+       ├─ commit: feat
+       ├─ commit: refactor
+       └─ PR → review → merge
+</flow>
+<conventions>
+feature/|bugfix/|hotfix/
+Conventional commits (feat|fix|docs|test|refactor)
+Squash merge to main
+</conventions>
+</pattern>
+
+<pattern id="definition-of-done">
+<name>Comprehensive Definition of Done</name>
+<checklist>
+✓ All Acceptance Criteria met
+✓ Tests written (TDD)
+✓ Tests passing (@test-runner)
+✓ Code formatted (black|prettier|eslint)
+✓ Linting clean (ruff|eslint)
+✓ Type checking passed (mypy|tsc)
+✓ Documentation updated
+✓ No TODOs or placeholders
+✓ No partial implementations
+✓ Security considered
+✓ Error handling implemented
+</checklist>
+</pattern>
+
+<pattern id="pr-template">
+<name>Standard PR Template</name>
+<template>
+## Summary
+- What: [changes made]
+- Why: [business/technical reason]
+- How: [approach taken]
+
+## Changes
+- Component A: [description]
+- Component B: [description]
+
+## Test Plan
+1. Automated: [test files]
+2. Manual: [verification steps]
+
+## Acceptance Criteria
+✓ AC1: [description]
+✓ AC2: [description]
+
+## Checklist
+✓ Tests pass
+✓ Linting clean
+✓ Documentation updated
+✓ Breaking changes noted
+</template>
+</pattern>
+
+<pattern id="context-optimization">
+<name>Agent-Based Context Preservation</name>
+<rule>Agent responses ≤ 20% of input data</rule>
+<techniques>
+- Summaries not full content
+- Key findings only
+- Actionable insights focus
+- Error patterns not raw logs
+- Use @file-analyzer for large files
+- Use @code-analyzer for deep dives
+- Use specialist agents for complex tasks
+</techniques>
+<ref>.claude/rules/context-optimization.md</ref>
+</pattern>
+
+<pattern id="real-services">
+<name>Real Services in Tests</name>
+<principle>No mocks|Use real implementations|Integration tests</principle>
+<why>
+Mocks hide bugs|Reality differs|Integration critical
+</why>
+<approach>
+# Use testcontainers
+docker run -d postgres:latest
+docker run -d redis:latest
+
+# Test against real services
+pytest tests/ --real-db --real-cache
+</approach>
+<ref>.claude/rules/test-execution.md</ref>
+</pattern>
+
+<pattern id="datetime-handling">
+<name>Real DateTime (No Placeholders)</name>
+<rule>Use real ISO 8601 UTC timestamps</rule>
+<prohibited>
+❌ "2024-01-01T00:00:00Z" (placeholder)
+❌ datetime.now() (timezone unaware)
+</prohibited>
+<correct>
+✓ datetime.now(UTC)
+✓ "2025-10-18T14:23:45.123Z" (actual time)
+</correct>
+<ref>.claude/rules/datetime.md</ref>
+</pattern>
+
+<pattern id="naming-conventions">
+<name>Code Quality Standards</name>
+<prohibited>
+❌ "_fixed" suffixes
+❌ "temp_" files
+❌ "WIP" commits
+❌ "TODO: add tests"
+❌ Hardcoded values
+❌ Magic numbers
+</prohibited>
+<required>
+✓ Descriptive names
+✓ Single responsibility
+✓ Meaningful tests
+✓ Error handling
+✓ Type annotations
+</required>
+<ref>.claude/rules/naming-conventions.md</ref>
+</pattern>
+
+</pattern_library>
+
+<usage>
+These patterns are MANDATORY, not optional.
+Follow them consistently across all projects.
+See full documentation in .claude/rules/ for details.
+</usage>
+
+<full_docs>
+.claude/rules/development-workflow.md
+.claude/rules/naming-conventions.md
+.claude/rules/test-execution.md
+.claude/rules/context-optimization.md
+</full_docs>

package/autopm/.claude/quick-ref/context7-queries.md

@@ -0,0 +1,122 @@
+# Context7 Documentation Queries (Quick Reference)
+
+<context7_usage>
+<when>
+ALWAYS query BEFORE implementing:
+- New features
+- Framework usage
+- API integration
+- Best practices
+- Design patterns
+</when>
+
+<why>
+Training data is stale|APIs change|Best practices evolve
+Context7 provides CURRENT documentation
+</why>
+</context7_usage>
+
+<query_format>
+mcp://context7/[library-name]/[topic]
+
+<examples>
+mcp://context7/fastapi/authentication
+mcp://context7/react/hooks
+mcp://context7/postgresql/indexing
+mcp://context7/kubernetes/deployments
+mcp://context7/aws/lambda
+</examples>
+</query_format>
+
+<common_queries>
+<backend>
+# Python
+mcp://context7/fastapi/routing
+mcp://context7/sqlalchemy/relationships
+mcp://context7/pydantic/validation
+
+# Node.js
+mcp://context7/express/middleware
+mcp://context7/nestjs/modules
+mcp://context7/prisma/migrations
+</backend>
+
+<frontend>
+# React
+mcp://context7/react/state-management
+mcp://context7/nextjs/routing
+mcp://context7/tailwindcss/utilities
+
+# Vue
+mcp://context7/vue/composition-api
+mcp://context7/nuxt/server-routes
+</frontend>
+
+<testing>
+mcp://context7/jest/mocking
+mcp://context7/pytest/fixtures
+mcp://context7/playwright/selectors
+mcp://context7/cypress/commands
+</testing>
+
+<cloud>
+# AWS
+mcp://context7/aws/ec2
+mcp://context7/aws/s3
+mcp://context7/cloudformation/resources
+
+# Azure
+mcp://context7/azure/app-service
+mcp://context7/azure/functions
+mcp://context7/bicep/modules
+
+# GCP
+mcp://context7/gcp/cloud-run
+mcp://context7/gcp/cloud-functions
+mcp://context7/terraform/gcp
+</cloud>
+
+<databases>
+mcp://context7/postgresql/performance
+mcp://context7/mongodb/aggregation
+mcp://context7/redis/caching
+mcp://context7/elasticsearch/queries
+</databases>
+
+<devops>
+mcp://context7/docker/multi-stage
+mcp://context7/kubernetes/helm
+mcp://context7/github-actions/workflows
+mcp://context7/terraform/modules
+</devops>
+</common_queries>
+
+<workflow_integration>
+<step1>Receive task</step1>
+<step2>Query Context7 for relevant docs</step2>
+<step3>Review documentation findings</step3>
+<step4>Implement using current best practices</step4>
+<step5>Verify against documentation</step5>
+</workflow_integration>
+
+<example>
+Task: "Implement user authentication with JWT"
+
+Queries:
+1. mcp://context7/fastapi/security
+2. mcp://context7/jwt/best-practices
+3. mcp://context7/pydantic/validation
+4. mcp://context7/sqlalchemy/user-models
+
+Result: Current, secure implementation using latest patterns
+</example>
+
+<obligations>
+✓ Query BEFORE implementing
+✓ Never rely solely on training data
+✓ Verify API signatures
+✓ Check for deprecations
+✓ Follow current patterns
+</obligations>
+
+<full_docs>.claude/rules/context7-enforcement.md</full_docs>