oh-my-customcode 0.1.4 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +80 -129
- package/dist/cli/index.js +273 -100
- package/dist/index.js +11 -53
- package/package.json +1 -1
- package/templates/{agents/sw-architect/documenter/AGENT.md → .claude/agents/arch-documenter.md} +7 -39
- package/templates/{agents/sw-architect/speckit-agent/AGENT.md → .claude/agents/arch-speckit-agent.md} +61 -63
- package/templates/.claude/agents/be-express-expert.md +71 -0
- package/templates/.claude/agents/be-fastapi-expert.md +33 -0
- package/templates/.claude/agents/be-go-backend-expert.md +33 -0
- package/templates/.claude/agents/be-nestjs-expert.md +51 -0
- package/templates/.claude/agents/be-springboot-expert.md +75 -0
- package/templates/.claude/agents/db-supabase-expert.md +63 -0
- package/templates/{agents/sw-engineer/frontend/svelte-agent/AGENT.md → .claude/agents/fe-svelte-agent.md} +16 -31
- package/templates/.claude/agents/fe-vercel-agent.md +57 -0
- package/templates/{agents/sw-engineer/frontend/vuejs-agent/AGENT.md → .claude/agents/fe-vuejs-agent.md} +16 -31
- package/templates/.claude/agents/infra-aws-expert.md +37 -0
- package/templates/.claude/agents/infra-docker-expert.md +37 -0
- package/templates/.claude/agents/lang-golang-expert.md +33 -0
- package/templates/.claude/agents/lang-java21-expert.md +56 -0
- package/templates/.claude/agents/lang-kotlin-expert.md +33 -0
- package/templates/.claude/agents/lang-python-expert.md +33 -0
- package/templates/.claude/agents/lang-rust-expert.md +33 -0
- package/templates/.claude/agents/lang-typescript-expert.md +33 -0
- package/templates/.claude/agents/mgr-creator.md +102 -0
- package/templates/{agents/manager/gitnerd/AGENT.md → .claude/agents/mgr-gitnerd.md} +8 -17
- package/templates/.claude/agents/mgr-sauron.md +139 -0
- package/templates/{agents/manager/supplier/AGENT.md → .claude/agents/mgr-supplier.md} +14 -46
- package/templates/.claude/agents/mgr-sync-checker.md +89 -0
- package/templates/{agents/manager/updater/AGENT.md → .claude/agents/mgr-updater.md} +21 -53
- package/templates/{agents/qa-team/qa-engineer/AGENT.md → .claude/agents/qa-engineer.md} +13 -24
- package/templates/{agents/qa-team/qa-planner/AGENT.md → .claude/agents/qa-planner.md} +10 -20
- package/templates/{agents/qa-team/qa-writer/AGENT.md → .claude/agents/qa-writer.md} +10 -20
- package/templates/.claude/agents/sys-memory-keeper.md +105 -0
- package/templates/.claude/agents/sys-naggy.md +81 -0
- package/templates/{agents/sw-engineer/tooling/bun-expert/AGENT.md → .claude/agents/tool-bun-expert.md} +28 -39
- package/templates/.claude/agents/tool-npm-expert.md +76 -0
- package/templates/.claude/agents/tool-optimizer.md +75 -0
- package/templates/{agents/tutor/go-tutor/AGENT.md → .claude/agents/tutor-go.md} +16 -27
- package/templates/.claude/contexts/ecomode.md +5 -5
- package/templates/.claude/rules/MUST-agent-design.md +60 -42
- package/templates/.claude/rules/MUST-agent-identification.md +11 -11
- package/templates/.claude/rules/MUST-continuous-improvement.md +2 -2
- package/templates/.claude/rules/MUST-intent-transparency.md +18 -18
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +192 -113
- package/templates/.claude/rules/MUST-parallel-execution.md +28 -28
- package/templates/.claude/rules/MUST-sync-verification.md +52 -45
- package/templates/.claude/rules/MUST-tool-identification.md +12 -14
- package/templates/.claude/rules/SHOULD-ecomode.md +3 -3
- package/templates/.claude/rules/SHOULD-hud-statusline.md +4 -4
- package/templates/.claude/rules/SHOULD-memory-integration.md +4 -4
- package/templates/.claude/rules/SHOULD-pipeline-mode.md +1 -1
- package/templates/.claude/skills/audit-agents/SKILL.md +116 -0
- package/templates/{skills/infrastructure → .claude/skills}/aws-best-practices/SKILL.md +4 -4
- package/templates/.claude/skills/create-agent/SKILL.md +91 -0
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +238 -0
- package/templates/{commands/dev/refactor.md → .claude/skills/dev-refactor/SKILL.md} +17 -20
- package/templates/{commands/dev/review.md → .claude/skills/dev-review/SKILL.md} +16 -17
- package/templates/{agents/manager/supplier/refs/skills/infrastructure → .claude/skills}/docker-best-practices/SKILL.md +4 -4
- package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/fastapi-best-practices/SKILL.md +4 -4
- package/templates/.claude/skills/fix-refs/SKILL.md +107 -0
- package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/go-backend-best-practices/SKILL.md +4 -4
- package/templates/{skills/development → .claude/skills}/go-best-practices/SKILL.md +4 -4
- package/templates/{commands/system/help.md → .claude/skills/help/SKILL.md} +34 -46
- package/templates/{skills/orchestration → .claude/skills}/intent-detection/SKILL.md +14 -14
- package/templates/{agents/manager/supplier/refs/skills/orchestration → .claude/skills}/intent-detection/patterns/agent-triggers.yaml +117 -110
- package/templates/{agents/sw-engineer/language/kotlin-expert/refs → .claude/skills}/kotlin-best-practices/SKILL.md +4 -4
- package/templates/{commands/system/lists.md → .claude/skills/lists/SKILL.md} +25 -33
- package/templates/{agents/manager/supplier/refs/skills/system → .claude/skills}/memory-management/SKILL.md +10 -10
- package/templates/{commands/memory/recall.md → .claude/skills/memory-recall/SKILL.md} +31 -43
- package/templates/{commands/memory/save.md → .claude/skills/memory-save/SKILL.md} +27 -29
- package/templates/.claude/skills/npm-audit/SKILL.md +72 -0
- package/templates/.claude/skills/npm-publish/SKILL.md +63 -0
- package/templates/.claude/skills/npm-version/SKILL.md +75 -0
- package/templates/.claude/skills/optimize-analyze/SKILL.md +55 -0
- package/templates/.claude/skills/optimize-bundle/SKILL.md +67 -0
- package/templates/.claude/skills/optimize-report/SKILL.md +74 -0
- package/templates/{skills/orchestration → .claude/skills}/pipeline-execution/SKILL.md +4 -4
- package/templates/{commands/pipeline/list.md → .claude/skills/pipeline-list/SKILL.md} +11 -18
- package/templates/{commands/pipeline/run.md → .claude/skills/pipeline-run/SKILL.md} +38 -22
- package/templates/{agents/sw-engineer/language/python-expert/refs → .claude/skills}/python-best-practices/SKILL.md +4 -4
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +277 -0
- package/templates/{skills/development → .claude/skills}/react-best-practices/SKILL.md +4 -4
- package/templates/{skills/system → .claude/skills}/result-aggregation/SKILL.md +17 -17
- package/templates/{agents/sw-engineer/language/rust-expert/refs → .claude/skills}/rust-best-practices/SKILL.md +4 -4
- package/templates/.claude/skills/sauron-watch/SKILL.md +144 -0
- package/templates/.claude/skills/secretary-routing/SKILL.md +178 -0
- package/templates/{skills/backend → .claude/skills}/springboot-best-practices/SKILL.md +4 -4
- package/templates/{commands/system/status.md → .claude/skills/status/SKILL.md} +29 -39
- package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +98 -0
- package/templates/{skills/development → .claude/skills}/typescript-best-practices/SKILL.md +4 -4
- package/templates/{commands/updater/docs.md → .claude/skills/update-docs/SKILL.md} +71 -96
- package/templates/{commands/updater/external.md → .claude/skills/update-external/SKILL.md} +34 -99
- package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/vercel-deploy/SKILL.md +4 -4
- package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/web-design-guidelines/SKILL.md +4 -4
- package/templates/CLAUDE.md.en +75 -100
- package/templates/CLAUDE.md.ko +74 -99
- package/templates/guides/aws/index.yaml +1 -1
- package/templates/guides/docker/index.yaml +1 -1
- package/templates/guides/fastapi/index.yaml +1 -1
- package/templates/guides/go-backend/index.yaml +1 -1
- package/templates/guides/golang/index.yaml +1 -1
- package/templates/guides/index.yaml +9 -0
- package/templates/guides/kotlin/index.yaml +1 -1
- package/templates/guides/python/index.yaml +1 -1
- package/templates/guides/rust/index.yaml +1 -1
- package/templates/guides/springboot/index.yaml +1 -1
- package/templates/guides/supabase-postgres/README.md +32 -0
- package/templates/guides/supabase-postgres/index.yaml +19 -0
- package/templates/guides/typescript/index.yaml +1 -1
- package/templates/manifest.json +9 -15
- package/templates/pipelines/examples/code-review.yaml +1 -1
- package/templates/agents/index.yaml +0 -243
- package/templates/agents/infra-engineer/aws-expert/AGENT.md +0 -47
- package/templates/agents/infra-engineer/aws-expert/index.yaml +0 -27
- package/templates/agents/infra-engineer/aws-expert/refs/aws/common-patterns.md +0 -169
- package/templates/agents/infra-engineer/aws-expert/refs/aws/index.yaml +0 -26
- package/templates/agents/infra-engineer/aws-expert/refs/aws/well-architected.md +0 -143
- package/templates/agents/infra-engineer/aws-expert/refs/aws-best-practices/SKILL.md +0 -279
- package/templates/agents/infra-engineer/aws-expert/refs/aws-best-practices/index.yaml +0 -27
- package/templates/agents/infra-engineer/docker-expert/AGENT.md +0 -47
- package/templates/agents/infra-engineer/docker-expert/index.yaml +0 -27
- package/templates/agents/infra-engineer/docker-expert/refs/docker/compose-best-practices.md +0 -284
- package/templates/agents/infra-engineer/docker-expert/refs/docker/dockerfile-best-practices.md +0 -262
- package/templates/agents/infra-engineer/docker-expert/refs/docker/index.yaml +0 -26
- package/templates/agents/infra-engineer/docker-expert/refs/docker-best-practices/SKILL.md +0 -274
- package/templates/agents/infra-engineer/docker-expert/refs/docker-best-practices/index.yaml +0 -26
- package/templates/agents/manager/creator/AGENT.md +0 -274
- package/templates/agents/manager/creator/index.yaml +0 -66
- package/templates/agents/manager/creator/refs/rules/MAY-optimization.md +0 -93
- package/templates/agents/manager/creator/refs/rules/MUST-agent-design.md +0 -107
- package/templates/agents/manager/creator/refs/rules/MUST-agent-identification.md +0 -108
- package/templates/agents/manager/creator/refs/rules/MUST-continuous-improvement.md +0 -132
- package/templates/agents/manager/creator/refs/rules/MUST-intent-transparency.md +0 -199
- package/templates/agents/manager/creator/refs/rules/MUST-language-policy.md +0 -62
- package/templates/agents/manager/creator/refs/rules/MUST-orchestrator-coordination.md +0 -334
- package/templates/agents/manager/creator/refs/rules/MUST-parallel-execution.md +0 -398
- package/templates/agents/manager/creator/refs/rules/MUST-permissions.md +0 -84
- package/templates/agents/manager/creator/refs/rules/MUST-safety.md +0 -69
- package/templates/agents/manager/creator/refs/rules/MUST-sync-verification.md +0 -219
- package/templates/agents/manager/creator/refs/rules/MUST-tool-identification.md +0 -174
- package/templates/agents/manager/creator/refs/rules/SHOULD-ecomode.md +0 -145
- package/templates/agents/manager/creator/refs/rules/SHOULD-error-handling.md +0 -102
- package/templates/agents/manager/creator/refs/rules/SHOULD-hud-statusline.md +0 -96
- package/templates/agents/manager/creator/refs/rules/SHOULD-interaction.md +0 -103
- package/templates/agents/manager/creator/refs/rules/SHOULD-memory-integration.md +0 -114
- package/templates/agents/manager/creator/refs/rules/SHOULD-pipeline-mode.md +0 -165
- package/templates/agents/manager/creator/refs/rules/index.yaml +0 -125
- package/templates/agents/manager/gitnerd/index.yaml +0 -55
- package/templates/agents/manager/sauron/AGENT.md +0 -153
- package/templates/agents/manager/sauron/index.yaml +0 -52
- package/templates/agents/manager/supplier/index.yaml +0 -31
- package/templates/agents/manager/supplier/refs/guides/aws/common-patterns.md +0 -169
- package/templates/agents/manager/supplier/refs/guides/aws/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/aws/well-architected.md +0 -143
- package/templates/agents/manager/supplier/refs/guides/claude-code/01-overview.md +0 -42
- package/templates/agents/manager/supplier/refs/guides/claude-code/03-tools.md +0 -107
- package/templates/agents/manager/supplier/refs/guides/claude-code/04-agent-skills.md +0 -90
- package/templates/agents/manager/supplier/refs/guides/claude-code/05-agent-sdk.md +0 -129
- package/templates/agents/manager/supplier/refs/guides/claude-code/06-mcp.md +0 -165
- package/templates/agents/manager/supplier/refs/guides/claude-code/07-prompt-engineering.md +0 -100
- package/templates/agents/manager/supplier/refs/guides/claude-code/08-testing.md +0 -58
- package/templates/agents/manager/supplier/refs/guides/claude-code/09-guardrails.md +0 -80
- package/templates/agents/manager/supplier/refs/guides/claude-code/10-monitoring.md +0 -89
- package/templates/agents/manager/supplier/refs/guides/claude-code/11-sub-agents.md +0 -159
- package/templates/agents/manager/supplier/refs/guides/claude-code/index.yaml +0 -51
- package/templates/agents/manager/supplier/refs/guides/docker/compose-best-practices.md +0 -284
- package/templates/agents/manager/supplier/refs/guides/docker/dockerfile-best-practices.md +0 -262
- package/templates/agents/manager/supplier/refs/guides/docker/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/fastapi/best-practices.md +0 -232
- package/templates/agents/manager/supplier/refs/guides/fastapi/index.yaml +0 -21
- package/templates/agents/manager/supplier/refs/guides/go-backend/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/go-backend/project-layout.md +0 -243
- package/templates/agents/manager/supplier/refs/guides/go-backend/uber-style.md +0 -212
- package/templates/agents/manager/supplier/refs/guides/golang/concurrency.md +0 -282
- package/templates/agents/manager/supplier/refs/guides/golang/effective-go.md +0 -309
- package/templates/agents/manager/supplier/refs/guides/golang/error-handling.md +0 -250
- package/templates/agents/manager/supplier/refs/guides/golang/index.yaml +0 -27
- package/templates/agents/manager/supplier/refs/guides/index.yaml +0 -101
- package/templates/agents/manager/supplier/refs/guides/kotlin/coding-conventions.md +0 -247
- package/templates/agents/manager/supplier/refs/guides/kotlin/idioms.md +0 -234
- package/templates/agents/manager/supplier/refs/guides/kotlin/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/python/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/python/pep8-style-guide.md +0 -202
- package/templates/agents/manager/supplier/refs/guides/python/zen-of-python.md +0 -79
- package/templates/agents/manager/supplier/refs/guides/rust/error-handling.md +0 -262
- package/templates/agents/manager/supplier/refs/guides/rust/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/rust/ownership.md +0 -180
- package/templates/agents/manager/supplier/refs/guides/springboot/best-practices.md +0 -361
- package/templates/agents/manager/supplier/refs/guides/springboot/index.yaml +0 -22
- package/templates/agents/manager/supplier/refs/guides/typescript/advanced-types.md +0 -225
- package/templates/agents/manager/supplier/refs/guides/typescript/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/guides/typescript/type-system.md +0 -219
- package/templates/agents/manager/supplier/refs/guides/web-design/accessibility.md +0 -66
- package/templates/agents/manager/supplier/refs/guides/web-design/index.yaml +0 -20
- package/templates/agents/manager/supplier/refs/guides/web-design/performance.md +0 -102
- package/templates/agents/manager/supplier/refs/rules/MAY-optimization.md +0 -93
- package/templates/agents/manager/supplier/refs/rules/MUST-agent-design.md +0 -107
- package/templates/agents/manager/supplier/refs/rules/MUST-agent-identification.md +0 -108
- package/templates/agents/manager/supplier/refs/rules/MUST-continuous-improvement.md +0 -132
- package/templates/agents/manager/supplier/refs/rules/MUST-intent-transparency.md +0 -199
- package/templates/agents/manager/supplier/refs/rules/MUST-language-policy.md +0 -62
- package/templates/agents/manager/supplier/refs/rules/MUST-orchestrator-coordination.md +0 -334
- package/templates/agents/manager/supplier/refs/rules/MUST-parallel-execution.md +0 -398
- package/templates/agents/manager/supplier/refs/rules/MUST-permissions.md +0 -84
- package/templates/agents/manager/supplier/refs/rules/MUST-safety.md +0 -69
- package/templates/agents/manager/supplier/refs/rules/MUST-sync-verification.md +0 -219
- package/templates/agents/manager/supplier/refs/rules/MUST-tool-identification.md +0 -174
- package/templates/agents/manager/supplier/refs/rules/SHOULD-ecomode.md +0 -145
- package/templates/agents/manager/supplier/refs/rules/SHOULD-error-handling.md +0 -102
- package/templates/agents/manager/supplier/refs/rules/SHOULD-hud-statusline.md +0 -96
- package/templates/agents/manager/supplier/refs/rules/SHOULD-interaction.md +0 -103
- package/templates/agents/manager/supplier/refs/rules/SHOULD-memory-integration.md +0 -114
- package/templates/agents/manager/supplier/refs/rules/SHOULD-pipeline-mode.md +0 -165
- package/templates/agents/manager/supplier/refs/rules/index.yaml +0 -125
- package/templates/agents/manager/supplier/refs/skills/backend/fastapi-best-practices/index.yaml +0 -25
- package/templates/agents/manager/supplier/refs/skills/backend/go-backend-best-practices/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/skills/backend/springboot-best-practices/SKILL.md +0 -356
- package/templates/agents/manager/supplier/refs/skills/backend/springboot-best-practices/index.yaml +0 -27
- package/templates/agents/manager/supplier/refs/skills/development/go-best-practices/SKILL.md +0 -202
- package/templates/agents/manager/supplier/refs/skills/development/go-best-practices/index.yaml +0 -25
- package/templates/agents/manager/supplier/refs/skills/development/kotlin-best-practices/SKILL.md +0 -255
- package/templates/agents/manager/supplier/refs/skills/development/kotlin-best-practices/index.yaml +0 -27
- package/templates/agents/manager/supplier/refs/skills/development/python-best-practices/SKILL.md +0 -221
- package/templates/agents/manager/supplier/refs/skills/development/python-best-practices/index.yaml +0 -25
- package/templates/agents/manager/supplier/refs/skills/development/react-best-practices/SKILL.md +0 -100
- package/templates/agents/manager/supplier/refs/skills/development/react-best-practices/index.yaml +0 -39
- package/templates/agents/manager/supplier/refs/skills/development/rust-best-practices/SKILL.md +0 -266
- package/templates/agents/manager/supplier/refs/skills/development/rust-best-practices/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/skills/development/typescript-best-practices/SKILL.md +0 -320
- package/templates/agents/manager/supplier/refs/skills/development/typescript-best-practices/index.yaml +0 -28
- package/templates/agents/manager/supplier/refs/skills/development/vercel-deploy/index.yaml +0 -30
- package/templates/agents/manager/supplier/refs/skills/development/web-design-guidelines/index.yaml +0 -34
- package/templates/agents/manager/supplier/refs/skills/index.yaml +0 -129
- package/templates/agents/manager/supplier/refs/skills/infrastructure/aws-best-practices/SKILL.md +0 -279
- package/templates/agents/manager/supplier/refs/skills/infrastructure/aws-best-practices/index.yaml +0 -27
- package/templates/agents/manager/supplier/refs/skills/infrastructure/docker-best-practices/index.yaml +0 -26
- package/templates/agents/manager/supplier/refs/skills/orchestration/intent-detection/SKILL.md +0 -214
- package/templates/agents/manager/supplier/refs/skills/orchestration/intent-detection/index.yaml +0 -30
- package/templates/agents/manager/supplier/refs/skills/orchestration/pipeline-execution/SKILL.md +0 -188
- package/templates/agents/manager/supplier/refs/skills/orchestration/pipeline-execution/index.yaml +0 -27
- package/templates/agents/manager/supplier/refs/skills/system/memory-management/index.yaml +0 -30
- package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/SKILL.md +0 -163
- package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/index.yaml +0 -36
- package/templates/agents/manager/sync-checker/AGENT.md +0 -34
- package/templates/agents/manager/sync-checker/index.yaml +0 -32
- package/templates/agents/manager/updater/index.yaml +0 -31
- package/templates/agents/manager/updater/refs/rules/MAY-optimization.md +0 -93
- package/templates/agents/manager/updater/refs/rules/MUST-agent-design.md +0 -107
- package/templates/agents/manager/updater/refs/rules/MUST-agent-identification.md +0 -108
- package/templates/agents/manager/updater/refs/rules/MUST-continuous-improvement.md +0 -132
- package/templates/agents/manager/updater/refs/rules/MUST-intent-transparency.md +0 -199
- package/templates/agents/manager/updater/refs/rules/MUST-language-policy.md +0 -62
- package/templates/agents/manager/updater/refs/rules/MUST-orchestrator-coordination.md +0 -334
- package/templates/agents/manager/updater/refs/rules/MUST-parallel-execution.md +0 -398
- package/templates/agents/manager/updater/refs/rules/MUST-permissions.md +0 -84
- package/templates/agents/manager/updater/refs/rules/MUST-safety.md +0 -69
- package/templates/agents/manager/updater/refs/rules/MUST-sync-verification.md +0 -219
- package/templates/agents/manager/updater/refs/rules/MUST-tool-identification.md +0 -174
- package/templates/agents/manager/updater/refs/rules/SHOULD-ecomode.md +0 -145
- package/templates/agents/manager/updater/refs/rules/SHOULD-error-handling.md +0 -102
- package/templates/agents/manager/updater/refs/rules/SHOULD-hud-statusline.md +0 -96
- package/templates/agents/manager/updater/refs/rules/SHOULD-interaction.md +0 -103
- package/templates/agents/manager/updater/refs/rules/SHOULD-memory-integration.md +0 -114
- package/templates/agents/manager/updater/refs/rules/SHOULD-pipeline-mode.md +0 -165
- package/templates/agents/manager/updater/refs/rules/index.yaml +0 -125
- package/templates/agents/orchestrator/dev-lead/AGENT.md +0 -163
- package/templates/agents/orchestrator/dev-lead/index.yaml +0 -73
- package/templates/agents/orchestrator/planner/AGENT.md +0 -102
- package/templates/agents/orchestrator/planner/index.yaml +0 -38
- package/templates/agents/orchestrator/qa-lead/AGENT.md +0 -92
- package/templates/agents/orchestrator/qa-lead/index.yaml +0 -40
- package/templates/agents/orchestrator/secretary/AGENT.md +0 -181
- package/templates/agents/orchestrator/secretary/index.yaml +0 -55
- package/templates/agents/orchestrator/secretary/refs/rules/MAY-optimization.md +0 -93
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-agent-design.md +0 -107
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-agent-identification.md +0 -108
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-continuous-improvement.md +0 -132
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-intent-transparency.md +0 -199
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-language-policy.md +0 -62
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-orchestrator-coordination.md +0 -334
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-parallel-execution.md +0 -398
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-permissions.md +0 -84
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-safety.md +0 -69
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-sync-verification.md +0 -219
- package/templates/agents/orchestrator/secretary/refs/rules/MUST-tool-identification.md +0 -174
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-ecomode.md +0 -145
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-error-handling.md +0 -102
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-hud-statusline.md +0 -96
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-interaction.md +0 -103
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-memory-integration.md +0 -114
- package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-pipeline-mode.md +0 -165
- package/templates/agents/orchestrator/secretary/refs/rules/index.yaml +0 -125
- package/templates/agents/qa-team/qa-engineer/index.yaml +0 -59
- package/templates/agents/qa-team/qa-planner/index.yaml +0 -47
- package/templates/agents/qa-team/qa-writer/index.yaml +0 -44
- package/templates/agents/sw-architect/documenter/index.yaml +0 -39
- package/templates/agents/sw-architect/speckit-agent/index.yaml +0 -78
- package/templates/agents/sw-engineer/backend/express-expert/AGENT.md +0 -132
- package/templates/agents/sw-engineer/backend/express-expert/index.yaml +0 -36
- package/templates/agents/sw-engineer/backend/fastapi-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/backend/fastapi-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi/best-practices.md +0 -232
- package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi/index.yaml +0 -21
- package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi-best-practices/SKILL.md +0 -269
- package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi-best-practices/index.yaml +0 -25
- package/templates/agents/sw-engineer/backend/go-backend-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/backend/go-backend-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/index.yaml +0 -26
- package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/project-layout.md +0 -243
- package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/uber-style.md +0 -212
- package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend-best-practices/SKILL.md +0 -337
- package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend-best-practices/index.yaml +0 -26
- package/templates/agents/sw-engineer/backend/nestjs-expert/AGENT.md +0 -107
- package/templates/agents/sw-engineer/backend/nestjs-expert/index.yaml +0 -43
- package/templates/agents/sw-engineer/backend/springboot-expert/AGENT.md +0 -103
- package/templates/agents/sw-engineer/backend/springboot-expert/index.yaml +0 -69
- package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot/best-practices.md +0 -361
- package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot/index.yaml +0 -22
- package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot-best-practices/SKILL.md +0 -356
- package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot-best-practices/index.yaml +0 -27
- package/templates/agents/sw-engineer/frontend/svelte-agent/index.yaml +0 -41
- package/templates/agents/sw-engineer/frontend/vercel-agent/AGENT.md +0 -67
- package/templates/agents/sw-engineer/frontend/vercel-agent/index.yaml +0 -43
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/react-best-practices/SKILL.md +0 -100
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/react-best-practices/index.yaml +0 -39
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/vercel-deploy/SKILL.md +0 -73
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/vercel-deploy/index.yaml +0 -30
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/accessibility.md +0 -66
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/index.yaml +0 -20
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/performance.md +0 -102
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design-guidelines/SKILL.md +0 -117
- package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design-guidelines/index.yaml +0 -34
- package/templates/agents/sw-engineer/frontend/vuejs-agent/index.yaml +0 -48
- package/templates/agents/sw-engineer/language/golang-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/language/golang-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/golang-expert/refs/go-best-practices/SKILL.md +0 -202
- package/templates/agents/sw-engineer/language/golang-expert/refs/go-best-practices/index.yaml +0 -25
- package/templates/agents/sw-engineer/language/golang-expert/refs/golang/concurrency.md +0 -282
- package/templates/agents/sw-engineer/language/golang-expert/refs/golang/effective-go.md +0 -309
- package/templates/agents/sw-engineer/language/golang-expert/refs/golang/error-handling.md +0 -250
- package/templates/agents/sw-engineer/language/golang-expert/refs/golang/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/java21-expert/AGENT.md +0 -122
- package/templates/agents/sw-engineer/language/java21-expert/index.yaml +0 -51
- package/templates/agents/sw-engineer/language/kotlin-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/language/kotlin-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/coding-conventions.md +0 -247
- package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/idioms.md +0 -234
- package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/index.yaml +0 -26
- package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin-best-practices/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/python-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/language/python-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/python-expert/refs/python/index.yaml +0 -26
- package/templates/agents/sw-engineer/language/python-expert/refs/python/pep8-style-guide.md +0 -202
- package/templates/agents/sw-engineer/language/python-expert/refs/python/zen-of-python.md +0 -79
- package/templates/agents/sw-engineer/language/python-expert/refs/python-best-practices/index.yaml +0 -25
- package/templates/agents/sw-engineer/language/rust-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/language/rust-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/rust-expert/refs/rust/error-handling.md +0 -262
- package/templates/agents/sw-engineer/language/rust-expert/refs/rust/index.yaml +0 -26
- package/templates/agents/sw-engineer/language/rust-expert/refs/rust/ownership.md +0 -180
- package/templates/agents/sw-engineer/language/rust-expert/refs/rust-best-practices/index.yaml +0 -26
- package/templates/agents/sw-engineer/language/typescript-expert/AGENT.md +0 -47
- package/templates/agents/sw-engineer/language/typescript-expert/index.yaml +0 -27
- package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/advanced-types.md +0 -225
- package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/index.yaml +0 -26
- package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/type-system.md +0 -219
- package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/SKILL.md +0 -320
- package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/index.yaml +0 -28
- package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml +0 -46
- package/templates/agents/sw-engineer/tooling/npm-expert/AGENT.md +0 -160
- package/templates/agents/sw-engineer/tooling/npm-expert/index.yaml +0 -45
- package/templates/agents/sw-engineer/tooling/optimizer/AGENT.md +0 -170
- package/templates/agents/sw-engineer/tooling/optimizer/index.yaml +0 -45
- package/templates/agents/system/memory-keeper/AGENT.md +0 -126
- package/templates/agents/system/memory-keeper/index.yaml +0 -45
- package/templates/agents/system/naggy/AGENT.md +0 -72
- package/templates/agents/system/naggy/index.yaml +0 -35
- package/templates/agents/tutor/go-tutor/index.yaml +0 -48
- package/templates/commands/COMMANDS.md +0 -136
- package/templates/commands/creator/agent.md +0 -121
- package/templates/commands/git/branch.yaml +0 -8
- package/templates/commands/git/commit.yaml +0 -4
- package/templates/commands/git/pr.yaml +0 -4
- package/templates/commands/git/status.yaml +0 -4
- package/templates/commands/git/sync.yaml +0 -4
- package/templates/commands/index.yaml +0 -225
- package/templates/commands/intent/explain.md +0 -144
- package/templates/commands/naggy/add.yaml +0 -8
- package/templates/commands/naggy/done.yaml +0 -8
- package/templates/commands/naggy/list.yaml +0 -4
- package/templates/commands/naggy/priority.yaml +0 -11
- package/templates/commands/naggy/remind.yaml +0 -4
- package/templates/commands/npm/audit.yaml +0 -62
- package/templates/commands/npm/publish.yaml +0 -52
- package/templates/commands/npm/version.yaml +0 -62
- package/templates/commands/optimize/analyze.yaml +0 -34
- package/templates/commands/optimize/bundle.yaml +0 -50
- package/templates/commands/optimize/report.yaml +0 -56
- package/templates/commands/sauron/quick.yaml +0 -4
- package/templates/commands/sauron/report.yaml +0 -4
- package/templates/commands/sauron/watch.yaml +0 -4
- package/templates/commands/supplier/audit.md +0 -133
- package/templates/commands/supplier/fix.md +0 -121
- package/templates/commands/sync/agents.yaml +0 -4
- package/templates/commands/sync/check.yaml +0 -4
- package/templates/commands/sync/commands.yaml +0 -4
- package/templates/commands/sync/docs.yaml +0 -4
- package/templates/commands/sync/fix.yaml +0 -4
- package/templates/skills/backend/fastapi-best-practices/SKILL.md +0 -269
- package/templates/skills/backend/fastapi-best-practices/index.yaml +0 -25
- package/templates/skills/backend/go-backend-best-practices/SKILL.md +0 -337
- package/templates/skills/backend/go-backend-best-practices/index.yaml +0 -26
- package/templates/skills/backend/springboot-best-practices/index.yaml +0 -27
- package/templates/skills/development/go-best-practices/index.yaml +0 -25
- package/templates/skills/development/kotlin-best-practices/SKILL.md +0 -255
- package/templates/skills/development/kotlin-best-practices/index.yaml +0 -27
- package/templates/skills/development/python-best-practices/SKILL.md +0 -221
- package/templates/skills/development/python-best-practices/index.yaml +0 -25
- package/templates/skills/development/react-best-practices/index.yaml +0 -39
- package/templates/skills/development/rust-best-practices/SKILL.md +0 -266
- package/templates/skills/development/rust-best-practices/index.yaml +0 -26
- package/templates/skills/development/typescript-best-practices/index.yaml +0 -28
- package/templates/skills/development/vercel-deploy/SKILL.md +0 -73
- package/templates/skills/development/vercel-deploy/index.yaml +0 -30
- package/templates/skills/development/web-design-guidelines/SKILL.md +0 -117
- package/templates/skills/development/web-design-guidelines/index.yaml +0 -34
- package/templates/skills/index.yaml +0 -129
- package/templates/skills/infrastructure/aws-best-practices/index.yaml +0 -27
- package/templates/skills/infrastructure/docker-best-practices/SKILL.md +0 -274
- package/templates/skills/infrastructure/docker-best-practices/index.yaml +0 -26
- package/templates/skills/orchestration/intent-detection/index.yaml +0 -30
- package/templates/skills/orchestration/intent-detection/patterns/agent-triggers.yaml +0 -342
- package/templates/skills/orchestration/pipeline-execution/index.yaml +0 -27
- package/templates/skills/system/memory-management/SKILL.md +0 -194
- package/templates/skills/system/memory-management/index.yaml +0 -30
- package/templates/skills/system/result-aggregation/index.yaml +0 -36
|
@@ -6,130 +6,143 @@
|
|
|
6
6
|
|
|
7
7
|
## CRITICAL
|
|
8
8
|
|
|
9
|
-
**
|
|
9
|
+
**The MAIN CONVERSATION is the sole orchestrator. It uses routing skills to delegate tasks to specialized subagents.**
|
|
10
10
|
|
|
11
|
-
###
|
|
11
|
+
### Flat Architecture (MANDATORY)
|
|
12
12
|
|
|
13
13
|
```
|
|
14
14
|
╔══════════════════════════════════════════════════════════════════╗
|
|
15
|
-
║
|
|
15
|
+
║ NEW ARCHITECTURE: FLAT, NO HIERARCHY ║
|
|
16
16
|
║ ║
|
|
17
|
-
║
|
|
18
|
-
║
|
|
19
|
-
║
|
|
20
|
-
║
|
|
17
|
+
║ Main Conversation (orchestrator) ║
|
|
18
|
+
║ │ ║
|
|
19
|
+
║ ├─ Uses routing skills: ║
|
|
20
|
+
║ │ • secretary-routing (agent/system tasks) ║
|
|
21
|
+
║ │ • dev-lead-routing (development tasks) ║
|
|
22
|
+
║ │ • qa-lead-routing (QA tasks) ║
|
|
23
|
+
║ │ ║
|
|
24
|
+
║ └─ Spawns subagents (Task tool): ║
|
|
25
|
+
║ ├─ mgr-creator, mgr-updater, mgr-supplier (manager agents) ║
|
|
26
|
+
║ ├─ lang-golang-expert, lang-python-expert (language experts) ║
|
|
27
|
+
║ └─ be-springboot-expert, be-fastapi-expert (framework experts) ║
|
|
21
28
|
║ ║
|
|
22
|
-
║
|
|
23
|
-
║
|
|
24
|
-
║ ║
|
|
25
|
-
║ CORRECT after session restart: ║
|
|
26
|
-
║ dev-lead → Task(springboot-expert) → runs Bash/Edit/Write ║
|
|
29
|
+
║ IMPORTANT: Subagents CANNOT spawn other subagents ║
|
|
30
|
+
║ Only main conversation can spawn subagents ║
|
|
27
31
|
╚══════════════════════════════════════════════════════════════════╝
|
|
28
32
|
```
|
|
29
33
|
|
|
30
|
-
###
|
|
34
|
+
### Session Continuity (MANDATORY)
|
|
31
35
|
|
|
32
36
|
```
|
|
33
37
|
╔══════════════════════════════════════════════════════════════════╗
|
|
34
|
-
║
|
|
35
|
-
║ ║
|
|
36
|
-
║ ✗ Directly run Bash commands for code/build tasks ║
|
|
37
|
-
║ ✗ Directly Edit/Write source code files ║
|
|
38
|
-
║ ✗ Directly modify project configuration ║
|
|
38
|
+
║ AFTER SESSION RESTART / CONTEXT COMPACTION: ║
|
|
39
39
|
║ ║
|
|
40
|
-
║
|
|
40
|
+
║ 1. Re-read CLAUDE.md and rules IMMEDIATELY ║
|
|
41
|
+
║ 2. Agent delegation rules STILL APPLY ║
|
|
42
|
+
║ 3. Main conversation uses routing skills to identify agents ║
|
|
43
|
+
║ 4. Spawn subagents with Task tool for actual work ║
|
|
41
44
|
║ ║
|
|
42
|
-
║
|
|
43
|
-
║
|
|
44
|
-
║ ✓ Aggregate results from spawned agents ║
|
|
45
|
-
║ ✓ Report summary to user ║
|
|
45
|
+
║ WRONG after session restart: ║
|
|
46
|
+
║ Main conversation → directly writes code/runs builds ║
|
|
46
47
|
║ ║
|
|
47
|
-
║
|
|
48
|
+
║ CORRECT after session restart: ║
|
|
49
|
+
║ Main conversation → Task(be-springboot-expert) → code/build ║
|
|
48
50
|
╚══════════════════════════════════════════════════════════════════╝
|
|
49
51
|
```
|
|
50
52
|
|
|
51
|
-
###
|
|
53
|
+
### Routing Logic (MANDATORY)
|
|
52
54
|
|
|
53
55
|
```
|
|
54
56
|
╔══════════════════════════════════════════════════════════════════╗
|
|
55
|
-
║
|
|
57
|
+
║ HOW TO ROUTE TASKS ║
|
|
56
58
|
║ ║
|
|
57
|
-
║ Task Domain →
|
|
58
|
-
║
|
|
59
|
-
║ Agent creation/update/audit → secretary
|
|
60
|
-
║ Code review/refactoring → dev-lead
|
|
61
|
-
║ Feature implementation → dev-lead
|
|
62
|
-
║ Multi-language development → dev-lead
|
|
63
|
-
║
|
|
64
|
-
║
|
|
59
|
+
║ Task Domain → Routing Skill → Agent ║
|
|
60
|
+
║ ────────────────────────────────────────────────────────────── ║
|
|
61
|
+
║ Agent creation/update/audit → secretary-routing → mgr-creator ║
|
|
62
|
+
║ Code review/refactoring → dev-lead-routing → expert-* ║
|
|
63
|
+
║ Feature implementation → dev-lead-routing → expert-* ║
|
|
64
|
+
║ Multi-language development → dev-lead-routing → multiple ║
|
|
65
|
+
║ System operations → secretary-routing → manager ║
|
|
66
|
+
║ QA/Testing tasks → qa-lead-routing → qa-* ║
|
|
65
67
|
║ ║
|
|
66
|
-
║
|
|
67
|
-
║
|
|
68
|
+
║ Routing skills contain the logic for: ║
|
|
69
|
+
║ • Which agent to use for which task ║
|
|
70
|
+
║ • When to spawn multiple agents in parallel ║
|
|
71
|
+
║ • How to aggregate results ║
|
|
68
72
|
╚══════════════════════════════════════════════════════════════════╝
|
|
69
73
|
```
|
|
70
74
|
|
|
71
|
-
###
|
|
75
|
+
### Routing Skills
|
|
72
76
|
|
|
73
|
-
|
|
|
74
|
-
|
|
75
|
-
| **secretary** |
|
|
76
|
-
| **dev-lead** |
|
|
77
|
+
| Routing Skill | Manages | Handles |
|
|
78
|
+
|---------------|---------|---------|
|
|
79
|
+
| **secretary-routing** | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, sys-memory-keeper | Agent management, system operations |
|
|
80
|
+
| **dev-lead-routing** | language/framework experts | Development, code review, implementation |
|
|
81
|
+
| **qa-lead-routing** | qa-planner, qa-writer, qa-engineer | Testing, quality assurance |
|
|
77
82
|
|
|
78
83
|
```
|
|
79
|
-
Multi-agent detection:
|
|
84
|
+
Multi-agent detection (handled by routing skills):
|
|
80
85
|
- Task spans multiple domains (frontend + backend)
|
|
81
|
-
- Task requires different expertise (golang + python)
|
|
86
|
+
- Task requires different expertise (lang-golang + lang-python)
|
|
82
87
|
- Task involves batch operations on different resources
|
|
83
88
|
|
|
84
|
-
If multi-agent needed →
|
|
89
|
+
If multi-agent needed → Spawn multiple subagents in parallel
|
|
85
90
|
```
|
|
86
91
|
|
|
87
92
|
## Coordination Flow
|
|
88
93
|
|
|
89
94
|
```
|
|
90
|
-
CORRECT:
|
|
95
|
+
CORRECT (Flat Architecture):
|
|
91
96
|
User Request
|
|
92
97
|
│
|
|
93
98
|
▼
|
|
94
|
-
|
|
95
|
-
│
|
|
96
|
-
│ - Analyzes task
|
|
97
|
-
│ - Identifies required agents│
|
|
98
|
-
│ - Plans execution
|
|
99
|
-
|
|
99
|
+
┌─────────────────────────────────┐
|
|
100
|
+
│ Main Conversation │
|
|
101
|
+
│ - Analyzes task via routing │
|
|
102
|
+
│ - Identifies required agents │
|
|
103
|
+
│ - Plans execution │
|
|
104
|
+
└─────────────┬───────────────────┘
|
|
100
105
|
│
|
|
101
106
|
┌─────────┼─────────┐
|
|
102
107
|
▼ ▼ ▼
|
|
103
|
-
[
|
|
108
|
+
[Subagent-1] [Subagent-2] [Subagent-3]
|
|
109
|
+
(spawned via Task tool)
|
|
104
110
|
│ │ │
|
|
105
111
|
└─────────┼─────────┘
|
|
106
112
|
▼
|
|
107
|
-
|
|
108
|
-
│
|
|
109
|
-
│ - Aggregates results
|
|
110
|
-
│ - Reports to user
|
|
111
|
-
|
|
113
|
+
┌─────────────────────────────────┐
|
|
114
|
+
│ Main Conversation │
|
|
115
|
+
│ - Aggregates results │
|
|
116
|
+
│ - Reports to user │
|
|
117
|
+
└─────────────────────────────────┘
|
|
112
118
|
|
|
113
|
-
WRONG:
|
|
119
|
+
WRONG (Hierarchical):
|
|
120
|
+
User Request
|
|
121
|
+
│
|
|
122
|
+
▼
|
|
123
|
+
[Subagent-1] → spawns → [Subagent-2] → spawns → [Subagent-3]
|
|
124
|
+
(Subagents cannot spawn other subagents)
|
|
125
|
+
|
|
126
|
+
WRONG (No coordination):
|
|
114
127
|
User Request
|
|
115
128
|
│
|
|
116
129
|
▼
|
|
117
130
|
[Agent-1] → [Agent-2] → [Agent-3]
|
|
118
|
-
(
|
|
131
|
+
(Sequential execution without planning)
|
|
119
132
|
```
|
|
120
133
|
|
|
121
|
-
##
|
|
134
|
+
## Main Conversation Responsibilities
|
|
122
135
|
|
|
123
136
|
```yaml
|
|
124
137
|
before_execution:
|
|
125
138
|
- Analyze user request
|
|
139
|
+
- Apply routing skill (secretary/dev-lead/qa-lead)
|
|
126
140
|
- Identify required agents
|
|
127
|
-
- Check agent availability
|
|
128
141
|
- Plan execution order (parallel vs sequential)
|
|
129
142
|
- Announce coordination plan
|
|
130
143
|
|
|
131
144
|
during_execution:
|
|
132
|
-
- Spawn
|
|
145
|
+
- Spawn subagent instances via Task tool
|
|
133
146
|
- Monitor progress
|
|
134
147
|
- Handle failures
|
|
135
148
|
- Coordinate dependencies
|
|
@@ -142,40 +155,39 @@ after_execution:
|
|
|
142
155
|
|
|
143
156
|
## Announcement Format
|
|
144
157
|
|
|
145
|
-
|
|
158
|
+
Main conversation MUST announce before delegating:
|
|
146
159
|
|
|
147
160
|
```
|
|
148
|
-
|
|
149
|
-
└─ Task: Coordinating multi-agent task
|
|
161
|
+
[Routing] Using dev-lead-routing for code review
|
|
150
162
|
|
|
151
163
|
[Plan]
|
|
152
|
-
├── Agent 1: golang-expert → Review Go code
|
|
153
|
-
├── Agent 2: python-expert → Review Python code
|
|
154
|
-
└── Agent 3: typescript-expert → Review TS code
|
|
164
|
+
├── Agent 1: lang-golang-expert → Review Go code
|
|
165
|
+
├── Agent 2: lang-python-expert → Review Python code
|
|
166
|
+
└── Agent 3: lang-typescript-expert → Review TS code
|
|
155
167
|
|
|
156
168
|
[Execution] Parallel (3 instances)
|
|
157
169
|
|
|
158
|
-
Spawning
|
|
170
|
+
Spawning subagents...
|
|
159
171
|
```
|
|
160
172
|
|
|
161
|
-
## When to
|
|
173
|
+
## When to Spawn Subagents
|
|
162
174
|
|
|
163
|
-
| Scenario |
|
|
164
|
-
|
|
165
|
-
| Single domain, single file |
|
|
166
|
-
| Single domain, multiple files |
|
|
175
|
+
| Scenario | Spawn Subagents? |
|
|
176
|
+
|----------|------------------|
|
|
177
|
+
| Single domain, single file | Maybe (if specialized agent needed) |
|
|
178
|
+
| Single domain, multiple files | Yes (if parallel beneficial) |
|
|
167
179
|
| Multiple domains | **Yes** |
|
|
168
180
|
| Batch operations | **Yes** |
|
|
169
181
|
| Complex workflow | **Yes** |
|
|
170
182
|
|
|
171
183
|
## Exception: Simple Tasks
|
|
172
184
|
|
|
173
|
-
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
- Direct
|
|
185
|
+
Subagent NOT required for:
|
|
186
|
+
- Reading files for analysis
|
|
187
|
+
- Simple file searches
|
|
188
|
+
- Direct questions answered by main conversation
|
|
177
189
|
|
|
178
|
-
|
|
190
|
+
For specialized work, ALWAYS delegate to appropriate subagent.
|
|
179
191
|
|
|
180
192
|
## CRITICAL: Use Specialized Manager Agents
|
|
181
193
|
|
|
@@ -187,10 +199,10 @@ These can be handled by the appropriate agent directly.
|
|
|
187
199
|
║ ║
|
|
188
200
|
║ Task Type → Required Agent ║
|
|
189
201
|
║ ───────────────────────────────────────────────── ║
|
|
190
|
-
║ Create new agent → creator
|
|
191
|
-
║ Update external agent → updater
|
|
192
|
-
║ Audit dependencies → supplier
|
|
193
|
-
║ Memory operations → memory-keeper
|
|
202
|
+
║ Create new agent → mgr-creator ║
|
|
203
|
+
║ Update external agent → mgr-updater ║
|
|
204
|
+
║ Audit dependencies → mgr-supplier ║
|
|
205
|
+
║ Memory operations → sys-memory-keeper ║
|
|
194
206
|
║ ║
|
|
195
207
|
║ DO NOT use general-purpose agents for these tasks. ║
|
|
196
208
|
║ DO NOT have secretary do the work directly. ║
|
|
@@ -200,31 +212,31 @@ These can be handled by the appropriate agent directly.
|
|
|
200
212
|
### Correct Delegation Pattern
|
|
201
213
|
|
|
202
214
|
```
|
|
203
|
-
User: "java21-expert 에이전트를 만들어줘"
|
|
215
|
+
User: "lang-java21-expert 에이전트를 만들어줘"
|
|
204
216
|
|
|
205
217
|
WRONG:
|
|
206
218
|
secretary → Task(general-purpose) → creates files directly
|
|
207
219
|
|
|
208
220
|
CORRECT:
|
|
209
|
-
secretary → Task(creator agent role) → follows creator workflow
|
|
221
|
+
secretary → Task(mgr-creator agent role) → follows creator workflow
|
|
210
222
|
```
|
|
211
223
|
|
|
212
224
|
### Manager Agents Reference
|
|
213
225
|
|
|
214
|
-
| Agent |
|
|
215
|
-
|
|
216
|
-
| creator | agents/
|
|
217
|
-
| updater | agents/
|
|
218
|
-
| supplier | agents/
|
|
219
|
-
| gitnerd | agents/
|
|
220
|
-
| sync-checker | agents/
|
|
226
|
+
| Agent | File | Purpose |
|
|
227
|
+
|-------|------|---------|
|
|
228
|
+
| mgr-creator | .claude/agents/mgr-creator.md | Create new agents |
|
|
229
|
+
| mgr-updater | .claude/agents/mgr-updater.md | Update external sources |
|
|
230
|
+
| mgr-supplier | .claude/agents/mgr-supplier.md | Audit dependencies |
|
|
231
|
+
| mgr-gitnerd | .claude/agents/mgr-gitnerd.md | Git operations (commit, push, PR) |
|
|
232
|
+
| mgr-sync-checker | .claude/agents/mgr-sync-checker.md | Documentation sync verification |
|
|
221
233
|
|
|
222
234
|
### System Agents Reference
|
|
223
235
|
|
|
224
|
-
| Agent |
|
|
225
|
-
|
|
226
|
-
| memory-keeper | agents/
|
|
227
|
-
| naggy | agents/
|
|
236
|
+
| Agent | File | Purpose |
|
|
237
|
+
|-------|------|---------|
|
|
238
|
+
| sys-memory-keeper | .claude/agents/sys-memory-keeper.md | Memory operations |
|
|
239
|
+
| sys-naggy | .claude/agents/sys-naggy.md | TODO management |
|
|
228
240
|
|
|
229
241
|
## CRITICAL: Use Specialized Expert Agents for Code Work
|
|
230
242
|
|
|
@@ -234,16 +246,16 @@ CORRECT:
|
|
|
234
246
|
║ ║
|
|
235
247
|
║ Language/Framework → Required Agent ║
|
|
236
248
|
║ ───────────────────────────────────────────────── ║
|
|
237
|
-
║ Python/FastAPI backend → python-expert or fastapi-expert
|
|
238
|
-
║ TypeScript/Next.js frontend → typescript-expert or vercel-agent║
|
|
239
|
-
║ Go code → golang-expert
|
|
240
|
-
║ Kotlin/Spring → kotlin-expert or springboot-expert║
|
|
249
|
+
║ Python/FastAPI backend → lang-python-expert or be-fastapi-expert ║
|
|
250
|
+
║ TypeScript/Next.js frontend → lang-typescript-expert or fe-vercel-agent ║
|
|
251
|
+
║ Go code → lang-golang-expert ║
|
|
252
|
+
║ Kotlin/Spring → lang-kotlin-expert or be-springboot-expert ║
|
|
241
253
|
║ ║
|
|
242
254
|
║ WRONG: ║
|
|
243
255
|
║ secretary → Task(general-purpose) → writes Python code ║
|
|
244
256
|
║ ║
|
|
245
257
|
║ CORRECT: ║
|
|
246
|
-
║ secretary → Task(python-expert) → writes Python code
|
|
258
|
+
║ secretary → Task(lang-python-expert) → writes Python code ║
|
|
247
259
|
║ ║
|
|
248
260
|
║ general-purpose should ONLY be used when: ║
|
|
249
261
|
║ - No specialized agent exists for the task ║
|
|
@@ -251,6 +263,42 @@ CORRECT:
|
|
|
251
263
|
╚══════════════════════════════════════════════════════════════════╝
|
|
252
264
|
```
|
|
253
265
|
|
|
266
|
+
## CRITICAL: Use Specialized Agents for Documentation & Spec Writing
|
|
267
|
+
|
|
268
|
+
```
|
|
269
|
+
╔══════════════════════════════════════════════════════════════════╗
|
|
270
|
+
║ DOCUMENTATION/SPEC WORK MUST USE SPECIALIZED AGENTS ║
|
|
271
|
+
║ ║
|
|
272
|
+
║ Document Type → Required Agent ║
|
|
273
|
+
║ ───────────────────────────────────────────────── ║
|
|
274
|
+
║ Architecture docs/ADR → arch-documenter ║
|
|
275
|
+
║ API specification (OpenAPI) → arch-documenter ║
|
|
276
|
+
║ Technical design docs → arch-documenter ║
|
|
277
|
+
║ Frontend UI/page specs → fe-vercel-agent / fe-* agents ║
|
|
278
|
+
║ Component design specs → fe-vercel-agent / fe-* agents ║
|
|
279
|
+
║ CI/CD pipeline specs → mgr-gitnerd ║
|
|
280
|
+
║ GitHub repository config → mgr-gitnerd ║
|
|
281
|
+
║ Docker/infra specs → infra-docker-expert ║
|
|
282
|
+
║ AWS architecture specs → infra-aws-expert ║
|
|
283
|
+
║ Database schema specs → db-supabase-expert ║
|
|
284
|
+
║ Test strategy/plans → qa-planner ║
|
|
285
|
+
║ Test case documentation → qa-writer ║
|
|
286
|
+
║ ║
|
|
287
|
+
║ WRONG: ║
|
|
288
|
+
║ orchestrator → Task(general-purpose) → writes API spec ║
|
|
289
|
+
║ ║
|
|
290
|
+
║ CORRECT: ║
|
|
291
|
+
║ orchestrator → Task(arch-documenter) → writes API spec ║
|
|
292
|
+
║ ║
|
|
293
|
+
║ general-purpose should ONLY be used when: ║
|
|
294
|
+
║ - No specialized agent exists for the document type ║
|
|
295
|
+
║ - Document is truly generic (meeting notes, simple lists) ║
|
|
296
|
+
║ ║
|
|
297
|
+
║ RULE: If the document requires domain expertise to write ║
|
|
298
|
+
║ correctly, it MUST be delegated to the domain expert. ║
|
|
299
|
+
╚══════════════════════════════════════════════════════════════════╝
|
|
300
|
+
```
|
|
301
|
+
|
|
254
302
|
## CRITICAL: Sub-agent Model Specification
|
|
255
303
|
|
|
256
304
|
```
|
|
@@ -290,32 +338,63 @@ CORRECT:
|
|
|
290
338
|
| Agent Category | Model | Examples |
|
|
291
339
|
|----------------|-------|----------|
|
|
292
340
|
| Orchestrator judgment | `opus` | Complex routing decisions |
|
|
293
|
-
| Manager agents | `sonnet` | creator, updater, supplier |
|
|
341
|
+
| Manager agents | `sonnet` | mgr-creator, mgr-updater, mgr-supplier |
|
|
294
342
|
| Simple utilities | `haiku` | File operations, search |
|
|
295
|
-
| Expert agents | `sonnet` | golang-expert, python-expert |
|
|
343
|
+
| Expert agents | `sonnet` | lang-golang-expert, lang-python-expert |
|
|
296
344
|
|
|
297
345
|
## CRITICAL: Git Operations Delegation
|
|
298
346
|
|
|
299
347
|
```
|
|
300
348
|
╔══════════════════════════════════════════════════════════════════╗
|
|
301
|
-
║ GIT OPERATIONS MUST BE DELEGATED TO gitnerd
|
|
349
|
+
║ GIT OPERATIONS MUST BE DELEGATED TO mgr-gitnerd ║
|
|
302
350
|
║ ║
|
|
303
351
|
║ WRONG: ║
|
|
304
|
-
║
|
|
352
|
+
║ Main conversation → directly runs git commit/push ║
|
|
305
353
|
║ ║
|
|
306
354
|
║ CORRECT: ║
|
|
307
|
-
║
|
|
355
|
+
║ Main conversation → Task(mgr-gitnerd) → git commit/push ║
|
|
308
356
|
║ ║
|
|
309
|
-
║ gitnerd handles:
|
|
357
|
+
║ mgr-gitnerd handles: ║
|
|
310
358
|
║ ✓ git commit (with proper message format) ║
|
|
311
359
|
║ ✓ git push ║
|
|
312
|
-
║ ✓ git branch operations
|
|
313
|
-
║ ✓ PR creation
|
|
360
|
+
║ ✓ git branch operations ║
|
|
361
|
+
║ ✓ PR creation (gh pr create) ║
|
|
314
362
|
║ ║
|
|
315
363
|
║ This ensures: ║
|
|
316
364
|
║ - Consistent commit message format ║
|
|
317
|
-
║ - Safety checks before destructive operations
|
|
318
|
-
║ - Proper Co-Authored-By attribution
|
|
365
|
+
║ - Safety checks before destructive operations ║
|
|
366
|
+
║ - Proper Co-Authored-By attribution ║
|
|
367
|
+
╚══════════════════════════════════════════════════════════════════╝
|
|
368
|
+
```
|
|
369
|
+
|
|
370
|
+
## CRITICAL: External Skills vs Internal Rules
|
|
371
|
+
|
|
372
|
+
```
|
|
373
|
+
╔══════════════════════════════════════════════════════════════════╗
|
|
374
|
+
║ INTERNAL RULES ALWAYS TAKE PRECEDENCE OVER EXTERNAL SKILLS ║
|
|
375
|
+
║ ║
|
|
376
|
+
║ External skills (e.g., finishing-a-development-branch) may ║
|
|
377
|
+
║ instruct direct git operations. IGNORE those instructions and ║
|
|
378
|
+
║ apply internal rules instead. ║
|
|
379
|
+
║ ║
|
|
380
|
+
║ Translation: ║
|
|
381
|
+
║ External skill says → Internal rule requires ║
|
|
382
|
+
║ ───────────────────────────────────────────────────────────── ║
|
|
383
|
+
║ "git commit -m ..." → Task(mgr-gitnerd) commit ║
|
|
384
|
+
║ "git push ..." → Task(mgr-gitnerd) push ║
|
|
385
|
+
║ "gh pr create ..." → Task(mgr-gitnerd) create PR ║
|
|
386
|
+
║ "git merge ..." → Task(mgr-gitnerd) merge ║
|
|
387
|
+
║ ║
|
|
388
|
+
║ WRONG: ║
|
|
389
|
+
║ [Using finishing-a-development-branch skill] ║
|
|
390
|
+
║ Main conversation → directly runs "git push" as skill says ║
|
|
391
|
+
║ ║
|
|
392
|
+
║ CORRECT: ║
|
|
393
|
+
║ [Using finishing-a-development-branch skill] ║
|
|
394
|
+
║ Main conversation → Task(mgr-gitnerd) → git push ║
|
|
395
|
+
║ ║
|
|
396
|
+
║ The skill's WORKFLOW is followed, but git EXECUTION is ║
|
|
397
|
+
║ delegated to mgr-gitnerd per R010. ║
|
|
319
398
|
╚══════════════════════════════════════════════════════════════════╝
|
|
320
399
|
```
|
|
321
400
|
|
|
@@ -323,12 +402,12 @@ CORRECT:
|
|
|
323
402
|
|
|
324
403
|
```
|
|
325
404
|
Violation examples:
|
|
326
|
-
✗ Reviewing Go + Python + TypeScript without
|
|
405
|
+
✗ Reviewing Go + Python + TypeScript without routing/delegation
|
|
327
406
|
✗ Creating multiple agents without coordination plan
|
|
328
407
|
✗ Running parallel tasks without announcing execution plan
|
|
329
408
|
|
|
330
409
|
Correct examples:
|
|
331
|
-
✓
|
|
410
|
+
✓ Main conversation announces plan, spawns agents, aggregates results
|
|
332
411
|
✓ Clear execution plan with agent assignments
|
|
333
412
|
✓ Progress updates during multi-agent execution
|
|
334
413
|
```
|
|
@@ -48,7 +48,7 @@ Failure to parallelize independent tasks = Rule violation = Must be corrected.
|
|
|
48
48
|
║ → Spawn parallel agents instead. ║
|
|
49
49
|
║ ║
|
|
50
50
|
║ 3. Are there domain-specific experts available? ║
|
|
51
|
-
║ → YES: Delegate to them (kotlin-expert, springboot-expert)
|
|
51
|
+
║ → YES: Delegate to them (lang-kotlin-expert, be-springboot-expert) ║
|
|
52
52
|
║ → NO: Create general-purpose parallel agents ║
|
|
53
53
|
╚══════════════════════════════════════════════════════════════════╝
|
|
54
54
|
```
|
|
@@ -69,20 +69,20 @@ Failure to parallelize independent tasks = Rule violation = Must be corrected.
|
|
|
69
69
|
Secretary writes domain/, usecase/, infrastructure/ sequentially
|
|
70
70
|
|
|
71
71
|
✓ CORRECT: Delegate to specialists
|
|
72
|
-
Task(kotlin-expert → domain layer)
|
|
73
|
-
Task(springboot-expert → infrastructure layer)
|
|
74
|
-
Task(kotlin-expert → usecase layer)
|
|
72
|
+
Task(lang-kotlin-expert → domain layer)
|
|
73
|
+
Task(be-springboot-expert → infrastructure layer)
|
|
74
|
+
Task(lang-kotlin-expert → usecase layer)
|
|
75
75
|
|
|
76
76
|
❌ WRONG: Single Task delegating to multiple agents
|
|
77
|
-
Task(dev-lead → "coordinate kotlin-expert and springboot-expert")
|
|
77
|
+
Task(dev-lead → "coordinate lang-kotlin-expert and be-springboot-expert")
|
|
78
78
|
|
|
79
79
|
This creates a SEQUENTIAL bottleneck inside the Task!
|
|
80
80
|
|
|
81
81
|
✓ CORRECT: Multiple Tasks in parallel, one per agent
|
|
82
|
-
Task(kotlin-expert → usecase commands) ┐
|
|
83
|
-
Task(kotlin-expert → usecase queries) ├─ All spawned together
|
|
84
|
-
Task(springboot-expert → persistence)
|
|
85
|
-
Task(springboot-expert → security)
|
|
82
|
+
Task(lang-kotlin-expert → usecase commands) ┐
|
|
83
|
+
Task(lang-kotlin-expert → usecase queries) ├─ All spawned together
|
|
84
|
+
Task(be-springboot-expert → persistence) │
|
|
85
|
+
Task(be-springboot-expert → security) ┘
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
### Parallel Task Spawning Rule
|
|
@@ -257,10 +257,10 @@ User: "Create golang, python, rust, typescript expert agents"
|
|
|
257
257
|
|
|
258
258
|
Orchestrator (secretary):
|
|
259
259
|
│
|
|
260
|
-
├── [golang-expert] creator instance #1
|
|
261
|
-
├── [python-expert] creator instance #2
|
|
262
|
-
├── [rust-expert] creator instance #3
|
|
263
|
-
└── [typescript-expert] creator instance #4
|
|
260
|
+
├── [lang-golang-expert] mgr-creator instance #1
|
|
261
|
+
├── [lang-python-expert] mgr-creator instance #2
|
|
262
|
+
├── [lang-rust-expert] mgr-creator instance #3
|
|
263
|
+
└── [lang-typescript-expert] mgr-creator instance #4
|
|
264
264
|
|
|
265
265
|
Execution: Parallel (4 instances)
|
|
266
266
|
```
|
|
@@ -272,9 +272,9 @@ User: "/dev:review src/*.go src/*.py src/*.ts"
|
|
|
272
272
|
|
|
273
273
|
Orchestrator:
|
|
274
274
|
│
|
|
275
|
-
├── [src/*.go] golang-expert instance #1
|
|
276
|
-
├── [src/*.py] python-expert instance #2
|
|
277
|
-
└── [src/*.ts] typescript-expert instance #3
|
|
275
|
+
├── [src/*.go] lang-golang-expert instance #1
|
|
276
|
+
├── [src/*.py] lang-python-expert instance #2
|
|
277
|
+
└── [src/*.ts] lang-typescript-expert instance #3
|
|
278
278
|
|
|
279
279
|
Execution: Parallel (3 instances)
|
|
280
280
|
```
|
|
@@ -286,10 +286,10 @@ User: "Audit all agents"
|
|
|
286
286
|
|
|
287
287
|
Orchestrator (secretary):
|
|
288
288
|
│
|
|
289
|
-
├── [agent-1] supplier instance #1
|
|
290
|
-
├── [agent-2] supplier instance #2
|
|
291
|
-
├── [agent-3] supplier instance #3
|
|
292
|
-
└── [agent-4] supplier instance #4
|
|
289
|
+
├── [agent-1] mgr-supplier instance #1
|
|
290
|
+
├── [agent-2] mgr-supplier instance #2
|
|
291
|
+
├── [agent-3] mgr-supplier instance #3
|
|
292
|
+
└── [agent-4] mgr-supplier instance #4
|
|
293
293
|
|
|
294
294
|
Execution: Parallel (4 instances, batched if > 4)
|
|
295
295
|
```
|
|
@@ -353,17 +353,17 @@ When parallel execution occurs, MUST display `{task-name}:{model}` format:
|
|
|
353
353
|
|
|
354
354
|
[Parallel] Spawning 4 instances...
|
|
355
355
|
|
|
356
|
-
[Instance 1] creator
|
|
357
|
-
[Instance 2] creator
|
|
358
|
-
[Instance 3] creator
|
|
359
|
-
[Instance 4] creator
|
|
356
|
+
[Instance 1] mgr-creator:sonnet → lang-golang-expert
|
|
357
|
+
[Instance 2] mgr-creator:sonnet → lang-python-expert
|
|
358
|
+
[Instance 3] mgr-creator:sonnet → lang-rust-expert
|
|
359
|
+
[Instance 4] mgr-creator:sonnet → lang-typescript-expert
|
|
360
360
|
|
|
361
361
|
[Progress] ████████░░░░ 2/4
|
|
362
362
|
|
|
363
|
-
[Instance 1] creator
|
|
364
|
-
[Instance 2] creator
|
|
365
|
-
[Instance 3] creator
|
|
366
|
-
[Instance 4] creator
|
|
363
|
+
[Instance 1] mgr-creator:sonnet ✓ lang-golang-expert created
|
|
364
|
+
[Instance 2] mgr-creator:sonnet ✓ lang-python-expert created
|
|
365
|
+
[Instance 3] mgr-creator:sonnet ✓ lang-rust-expert created
|
|
366
|
+
[Instance 4] mgr-creator:sonnet ✓ lang-typescript-expert created
|
|
367
367
|
|
|
368
368
|
[Summary] 4/4 tasks completed successfully
|
|
369
369
|
```
|