claude-autopm 2.8.8 → 2.11.0

package/autopm/.claude/quick-ref/tdd-cycle.md

@@ -0,0 +1,49 @@
+# TDD Cycle (Quick Reference)
+
+<tdd_cycle>
+<phase id="RED">
+<action>Write failing test FIRST</action>
+<verify>@test-runner confirms RED ❌</verify>
+<commit>test: add failing test for [feature]</commit>
+</phase>
+
+<phase id="GREEN">
+<action>Write MINIMUM code to pass</action>
+<verify>@test-runner confirms GREEN ✅</verify>
+<commit>feat: implement [feature]</commit>
+</phase>
+
+<phase id="REFACTOR">
+<action>Improve code structure</action>
+<verify>@test-runner confirms still GREEN ✅</verify>
+<commit>refactor: improve [feature] structure</commit>
+</phase>
+</tdd_cycle>
+
+<example>
+```bash
+# RED
+touch tests/test_auth.py
+# Write test
+@test-runner run tests/test_auth.py  # Must be RED ❌
+git commit -m "test: add failing test for auth"
+
+# GREEN
+# Write minimal implementation
+@test-runner run tests/test_auth.py  # Must be GREEN ✅
+git commit -m "feat: implement auth endpoint"
+
+# REFACTOR
+# Improve code
+@test-runner run all tests  # Must be GREEN ✅
+git commit -m "refactor: improve auth structure"
+```
+</example>
+
+<prohibited>
+❌ Code before test
+❌ Skip any phase
+❌ "TODO: add tests"
+</prohibited>
+
+<full_docs>.claude/rules/tdd.enforcement.md</full_docs>

package/autopm/.claude/quick-ref/workflow-steps.md

@@ -0,0 +1,103 @@
+# Standard Task Workflow (Quick Reference)
+
+<workflow>
+<step id="1" name="Pick Task">
+<action>Select task from backlog (sorted by priority)</action>
+<verify>Check Acceptance Criteria + Definition of Done</verify>
+</step>
+
+<step id="2" name="Create Branch">
+<action>git checkout -b feature/task-name</action>
+<convention>feature/|bugfix/|hotfix/</convention>
+</step>
+
+<step id="3" name="Implement">
+<action>Follow TDD: RED→GREEN→REFACTOR</action>
+<agents>@test-runner|@code-analyzer|specialist agents</agents>
+<context7>Query docs BEFORE coding</context7>
+</step>
+
+<step id="4" name="Verify AC">
+<checklist>
+✓ All Acceptance Criteria met
+✓ Definition of Done complete
+✓ Tests passing (@test-runner)
+✓ Code formatted + linted
+✓ No partial implementations
+</checklist>
+</step>
+
+<step id="5" name="Create PR">
+<action>gh pr create --title "feat: description"</action>
+<template>
+## Summary
+- What changed
+- Why changed
+
+## Test Plan
+- How to verify
+
+## Checklist
+✓ Tests pass
+✓ Linting clean
+✓ Documentation updated
+</template>
+</step>
+
+<step id="6" name="Address Feedback">
+<action>Interpret + resolve ALL PR comments</action>
+<process>
+1. Read comment carefully
+2. Ask clarifying questions if unclear
+3. Implement requested changes
+4. Push updates
+5. Respond to comment
+</process>
+</step>
+
+<step id="7" name="Merge">
+<action>gh pr merge --squash</action>
+<requirements>
+✓ All checks pass
+✓ All comments resolved
+✓ No merge conflicts
+</requirements>
+</step>
+
+<step id="8" name="Complete">
+<action>Mark task status: "completed" (NOT "ready")</action>
+<cleanup>Delete feature branch</cleanup>
+</step>
+
+<step id="9" name="Next Task">
+<action>Return to step 1</action>
+</step>
+</workflow>
+
+<quick_commands>
+# Branch workflow
+git checkout -b feature/name
+git add .
+git commit -m "type: description"
+git push -u origin feature/name
+
+# PR workflow
+gh pr create
+gh pr view
+gh pr merge --squash
+
+# Verification
+@test-runner run all tests
+npm run lint
+npm run build
+</quick_commands>
+
+<prohibited>
+❌ Direct commits to main
+❌ PRs without tests
+❌ Merging with conflicts
+❌ Ignoring PR feedback
+❌ Status "ready" (use "completed")
+</prohibited>
+
+<full_docs>.claude/workflows/standard-task-workflow.md</full_docs>

package/autopm/.claude/rules/agent-mandatory-optimized.md

@@ -0,0 +1,91 @@
+# Agent Usage - MANDATORY (Optimized)
+
+<priority>HIGHEST - ZERO TOLERANCE</priority>
+
+<core_requirement>
+YOU MUST USE SPECIALIZED AGENTS FOR ALL NON-TRIVIAL TASKS
+Do NOT perform complex tasks yourself
+Use Task tool to delegate
+</core_requirement>
+
+<when_to_use>
+<always>
+Code writing|Testing|Infrastructure|Database|Analysis|GitHub ops|Large files
+</always>
+
+<mapping>
+Python → python-backend-engineer
+React → react-frontend-engineer
+Node.js → nodejs-backend-engineer
+Tests → test-runner|frontend-testing-engineer|e2e-test-engineer
+K8s → kubernetes-orchestrator
+Docker → docker-containerization-expert
+Database → postgresql-expert|mongodb-expert|bigquery-expert
+Review → code-analyzer
+Logs → file-analyzer
+GitHub → github-operations-specialist
+Azure → azure-devops-specialist
+</mapping>
+
+<can_do_yourself>
+Simple file reads (1-2 files)|Basic bash (ls, pwd, git)|Answering questions|TodoWrite
+</can_do_yourself>
+</when_to_use>
+
+<violations>
+<wrong>
+User: "Create FastAPI endpoint"
+You: *writes code directly*
+</wrong>
+
+<correct>
+User: "Create FastAPI endpoint"
+You: "Using @python-backend-engineer"
+*Invokes Task tool*
+</correct>
+</violations>
+
+<usage_patterns>
+<single>
+Task tool:
+- subagent_type: "python-backend-engineer"
+- description: "Create user endpoint"
+- prompt: "Detailed requirements..."
+</single>
+
+<parallel>
+Launch multiple agents IN SINGLE MESSAGE:
+- python-backend-engineer (API)
+- react-frontend-engineer (UI)
+- postgresql-expert (schema)
+</parallel>
+</usage_patterns>
+
+<decision_rule>
+Before ANY complex task:
+1. Is there a specialized agent?
+2. Would agent do better?
+3. Am I trying to do what I should delegate?
+
+YES to any? → USE THE AGENT
+When in doubt? → USE THE AGENT
+</decision_rule>
+
+<common_mistakes>
+❌ Not checking Active Team Agents
+❌ Writing code for non-trivial tasks
+❌ Not using parallel agents
+❌ Wrong agent for task
+❌ Not using file-analyzer for large files
+</common_mistakes>
+
+<enforcement>
+Git hooks|Code review|Self-monitoring
+Default: YES use agent|Over-use better than under-use
+</enforcement>
+
+<ref>
+Full version: .claude/rules/agent-mandatory.md
+Quick ref: .claude/quick-ref/agent-quick-ref.md
+Registry: .claude/agents/AGENT-REGISTRY.md
+</ref>

package/autopm/.claude/rules/context7-enforcement-optimized.md

@@ -0,0 +1,221 @@
+# Context7 Documentation Enforcement (Optimized)
+
+<priority>HIGHEST - ZERO TOLERANCE</priority>
+
+<visual_reminder>
+WHEN YOU SEE: `/pm:command` or `@agent-name`
+
+YOU MUST:
+1. 📖 ANNOUNCE: "Querying Context7..."
+2. 🔍 READ command/agent file → extract Documentation Queries
+3. 🌐 QUERY Context7 MCP for EACH listed topic
+4. 📝 SUMMARIZE key findings
+5. ✅ CONFIRM: "Context7 complete. Proceeding..."
+
+<output>
+🔒 Context7 Enforcement Active
+
+📋 Command: /pm:epic-decompose
+📚 Querying Context7...
+
+   ➜ mcp://context7/agile/epic-decomposition
+   ➜ mcp://context7/agile/task-sizing
+   ➜ mcp://context7/agile/user-stories
+
+✅ Context7 complete
+📖 Key findings: [summary]
+
+Proceeding with Context7 best practices...
+</output>
+</visual_reminder>
+
+<prime_directive>
+Query live documentation from Context7 BEFORE implementing
+No implementation without Context7 query
+No reliance on training data for technical specifics
+No shortcuts
+</prime_directive>
+
+<why_critical>
+<problems>
+Hallucinations|API changes|Best practices drift|Version conflicts
+Training data stale|Frameworks evolve|Deprecated patterns
+</problems>
+
+<benefits>
+Always current|Verified patterns|API accuracy|Breaking changes awareness
+Live documentation|Real examples|Current signatures|No guesswork
+</benefits>
+</why_critical>
+
+<context7_cycle>
+<query_phase>
+1. Read command/agent file → extract Documentation Queries
+2. Query EACH Context7 MCP link
+3. Analyze: patterns|APIs|best practices|anti-patterns
+4. Summarize findings before proceeding
+</query_phase>
+
+<implement_phase>
+Apply Context7 patterns EXACTLY as documented
+Use API signatures from Context7 (NOT training data)
+Follow architectural recommendations
+Reference Context7 in comments
+</implement_phase>
+
+<validate_phase>
+Implementation matches Context7
+No hallucinations
+Latest conventions followed
+Deprecation warnings addressed
+</validate_phase>
+</context7_cycle>
+
+<absolute_requirements>
+<commands>
+MUST read "Required Documentation Access"
+MUST query EVERY mcp:// link before execution
+MUST summarize Context7 findings
+MUST apply Context7 guidance
+</commands>
+
+<agents>
+MUST read "Documentation Queries"
+MUST query before technical decisions
+MUST verify API signatures
+MUST flag training data conflicts
+</agents>
+
+<implementations>
+NO code from training data alone
+NO assumptions without Context7
+NO "I think this works" - VERIFY
+NO skip for "small changes"
+</implementations>
+</absolute_requirements>
+
+<prohibited>
+❌ Implementing without querying
+❌ "I remember" - training data stale
+❌ Skip for "simple" tasks
+❌ Cached knowledge vs live docs
+❌ Proceed when query fails
+❌ Ignore Context7 guidance
+</prohibited>
+
+<query_quality>
+<do>
+✅ Query ALL listed links
+✅ Request specific topics
+✅ Ask for examples + patterns
+✅ Verify API signatures
+✅ Check breaking changes
+</do>
+
+<dont>
+❌ Skip assuming training data sufficient
+❌ Query only one link
+❌ Accept generic results
+❌ Ignore version mismatches
+</dont>
+
+<coverage>
+100% query rate|Complete coverage|Result validation|Stop if fails
+</coverage>
+</query_quality>
+
+<command_flow>
+User: /pm:epic-decompose feature-name
+
+BEFORE:
+1. Read .claude/commands/pm/epic-decompose.md
+2. Extract Documentation Queries
+3. Query Context7 for EACH link
+4. Summarize: "Context7 confirms INVEST criteria..."
+5. PROCEED with Context7 guidance
+
+DURING:
+Apply Context7 patterns|Reference examples|Follow best practices
+
+AFTER:
+Validate against Context7|Flag deviations
+</command_flow>
+
+<agent_flow>
+User: @aws-cloud-architect design VPC
+
+BEFORE:
+1. Read .claude/agents/cloud/aws-cloud-architect.md
+2. Extract Documentation Queries
+3. Query Context7 for EACH link
+4. Summarize: "Context7 shows VPC /16 for staging..."
+5. PROCEED with Context7 knowledge
+
+DURING:
+Current AWS API patterns|Terraform patterns|Networking best practices
+
+AFTER:
+Cross-check design|No deprecated patterns
+</agent_flow>
+
+<violations>
+<immediate>
+STOP execution|IDENTIFY unverified code|DELETE stale implementation|
+QUERY Context7|REIMPLEMENT|DOCUMENT violation
+</immediate>
+
+<severity>
+Level 1 (Minor): Partial queries → Complete + validate
+Level 2 (Moderate): No queries → Stop + query + review
+Level 3 (Critical): Contradicts Context7 → Delete + redo
+</severity>
+
+<no_exceptions>
+NO "small changes"|NO "I'm confident"|NO "Context7 slow"|NO assumptions
+</no_exceptions>
+</violations>
+
+<success_metrics>
+✅ 100% commands query Context7
+✅ 100% agents query Context7
+✅ Zero training-data-only implementations
+✅ All API signatures verified
+✅ No deprecated patterns
+✅ Findings documented
+</success_metrics>
+
+<automation>
+<hooks>
+.claude/hooks/pre-command-context7.js - Extract + query before commands
+.claude/hooks/pre-agent-context7.js - Extract + query before agents
+</hooks>
+
+<validation>
+.claude/rules/context7-enforcement.md - Highest priority rule
+Read on every session|Zero tolerance
+</validation>
+</automation>
+
+<emergency_fallback>
+If Context7 unavailable:
+1. ALERT: "⚠️ Context7 MCP unavailable"
+2. REQUEST user decision: WAIT (recommended) or PROCEED (risky)
+3. DOCUMENT: // WARNING: No Context7 verification - MCP unavailable
+4. FLAG: TODO re-verify when available
+
+DO NOT:
+❌ Silently proceed
+❌ Assume training data sufficient
+❌ Skip queries
+</emergency_fallback>
+
+<final_reminder>
+Context7 is MANDATORY for EVERY command and agent execution.
+Training data becomes stale. APIs change. Best practices evolve.
+Context7 keeps us current. Query it. Every. Single. Time.
+</final_reminder>
+
+<ref>
+Full version: .claude/rules/context7-enforcement.md
+Quick ref: .claude/quick-ref/context7-queries.md
+</ref>