codeforge-dev 1.13.0 → 1.14.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.
Files changed (148) hide show
  1. package/.devcontainer/CHANGELOG.md +140 -4
  2. package/.devcontainer/CLAUDE.md +61 -276
  3. package/.devcontainer/README.md +1 -1
  4. package/.devcontainer/config/defaults/ccstatusline-settings.json +147 -0
  5. package/.devcontainer/config/defaults/main-system-prompt.md +6 -1
  6. package/.devcontainer/config/defaults/rules/spec-workflow.md +1 -55
  7. package/.devcontainer/config/file-manifest.json +14 -0
  8. package/.devcontainer/devcontainer.json +19 -1
  9. package/.devcontainer/docs/optional-features.md +0 -65
  10. package/.devcontainer/docs/plugins.md +38 -23
  11. package/.devcontainer/features/ast-grep/devcontainer-feature.json +0 -1
  12. package/.devcontainer/features/biome/install.sh +13 -0
  13. package/.devcontainer/features/ccburn/devcontainer-feature.json +0 -1
  14. package/.devcontainer/features/ccms/devcontainer-feature.json +0 -1
  15. package/.devcontainer/features/ccms/install.sh +1 -1
  16. package/.devcontainer/features/ccstatusline/devcontainer-feature.json +0 -1
  17. package/.devcontainer/features/ccstatusline/install.sh +17 -115
  18. package/.devcontainer/features/ccusage/devcontainer-feature.json +0 -1
  19. package/.devcontainer/features/chromaterm/README.md +42 -0
  20. package/.devcontainer/features/chromaterm/chromaterm.yml +35 -0
  21. package/.devcontainer/features/chromaterm/devcontainer-feature.json +22 -0
  22. package/.devcontainer/features/chromaterm/install.sh +113 -0
  23. package/.devcontainer/features/claude-monitor/devcontainer-feature.json +0 -1
  24. package/.devcontainer/features/claude-session-dashboard/README.md +2 -2
  25. package/.devcontainer/features/claude-session-dashboard/devcontainer-feature.json +1 -2
  26. package/.devcontainer/features/claude-session-dashboard/install.sh +2 -2
  27. package/.devcontainer/features/kitty-terminfo/README.md +32 -0
  28. package/.devcontainer/features/kitty-terminfo/devcontainer-feature.json +13 -0
  29. package/.devcontainer/features/kitty-terminfo/install.sh +72 -0
  30. package/.devcontainer/features/lsp-servers/devcontainer-feature.json +0 -1
  31. package/.devcontainer/features/mcp-qdrant/devcontainer-feature.json +0 -1
  32. package/.devcontainer/features/shellcheck/install.sh +6 -2
  33. package/.devcontainer/features/tree-sitter/devcontainer-feature.json +0 -1
  34. package/.devcontainer/plugins/devs-marketplace/.claude-plugin/marketplace.json +37 -69
  35. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/.claude-plugin/plugin.json +0 -1
  36. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/README.md +197 -0
  37. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/architect.md +3 -1
  38. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/bash-exec.md +3 -0
  39. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/claude-guide.md +4 -1
  40. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/debug-logs.md +6 -1
  41. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/dependency-analyst.md +5 -1
  42. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/doc-writer.md +4 -1
  43. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/explorer.md +3 -1
  44. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/generalist.md +9 -1
  45. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/git-archaeologist.md +3 -0
  46. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/migrator.md +4 -1
  47. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/perf-profiler.md +4 -1
  48. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/refactorer.md +5 -1
  49. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/researcher.md +5 -1
  50. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/security-auditor.md +4 -1
  51. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/spec-writer.md +3 -1
  52. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/statusline-config.md +4 -1
  53. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/test-writer.md +4 -1
  54. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/hooks/hooks.json +23 -1
  55. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/guard-readonly-bash.py +2 -2
  56. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/inject-cwd.py +7 -4
  57. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/task-completed-check.py +166 -0
  58. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/teammate-idle-check.py +81 -0
  59. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/verify-no-regression.py +14 -10
  60. package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/scripts/verify-tests-pass.py +2 -14
  61. package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/README.md +17 -31
  62. package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/hooks/hooks.json +5 -1
  63. package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/scripts/advisory-test-runner.py +9 -8
  64. package/.devcontainer/plugins/devs-marketplace/plugins/codeforge-lsp/README.md +28 -0
  65. package/.devcontainer/plugins/devs-marketplace/plugins/dangerous-command-blocker/README.md +28 -0
  66. package/.devcontainer/plugins/devs-marketplace/plugins/dangerous-command-blocker/scripts/block-dangerous.py +2 -2
  67. package/.devcontainer/plugins/devs-marketplace/plugins/notify-hook/README.md +28 -0
  68. package/.devcontainer/plugins/devs-marketplace/plugins/notify-hook/hooks/hooks.json +0 -1
  69. package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/README.md +28 -0
  70. package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/scripts/guard-protected-bash.py +1 -1
  71. package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/scripts/guard-protected.py +2 -2
  72. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/.claude-plugin/plugin.json +0 -1
  73. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/README.md +140 -0
  74. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/hooks/hooks.json +0 -1
  75. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/scripts/commit-reminder.py +3 -2
  76. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/scripts/git-state-injector.py +18 -2
  77. package/.devcontainer/plugins/devs-marketplace/plugins/session-context/scripts/todo-harvester.py +9 -1
  78. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/.claude-plugin/plugin.json +0 -1
  79. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/README.md +158 -0
  80. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/hooks/hooks.json +1 -14
  81. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/scripts/skill-suggester.py +189 -100
  82. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/api-design/SKILL.md +9 -6
  83. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/ast-grep-patterns/SKILL.md +7 -6
  84. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-agent-sdk/SKILL.md +8 -8
  85. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-code-headless/SKILL.md +8 -9
  86. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/debugging/SKILL.md +11 -7
  87. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/dependency-management/SKILL.md +10 -6
  88. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker/SKILL.md +8 -8
  89. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker-py/SKILL.md +9 -7
  90. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/documentation-patterns/SKILL.md +7 -6
  91. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/fastapi/SKILL.md +9 -8
  92. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/git-forensics/SKILL.md +11 -9
  93. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/migration-patterns/SKILL.md +7 -6
  94. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/performance-profiling/SKILL.md +10 -8
  95. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/pydantic-ai/SKILL.md +8 -7
  96. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/refactoring-patterns/SKILL.md +9 -8
  97. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/security-checklist/SKILL.md +9 -8
  98. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/skill-building/SKILL.md +7 -7
  99. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/sqlite/SKILL.md +9 -7
  100. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/svelte5/SKILL.md +7 -8
  101. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/team/SKILL.md +71 -5
  102. package/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/testing/SKILL.md +10 -7
  103. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/.claude-plugin/plugin.json +0 -1
  104. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/README.md +192 -0
  105. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/hooks/hooks.json +0 -1
  106. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/scripts/spec-reminder.py +3 -2
  107. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-build/SKILL.md +9 -6
  108. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-check/SKILL.md +10 -5
  109. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-init/SKILL.md +8 -4
  110. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-new/SKILL.md +8 -4
  111. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-refine/SKILL.md +10 -7
  112. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-review/SKILL.md +10 -6
  113. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/spec-update/SKILL.md +10 -5
  114. package/.devcontainer/plugins/devs-marketplace/plugins/spec-workflow/skills/specification-writing/SKILL.md +9 -9
  115. package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/.claude-plugin/plugin.json +1 -2
  116. package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/README.md +28 -0
  117. package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/hooks/hooks.json +0 -1
  118. package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/scripts/ticket-linker.py +9 -1
  119. package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/README.md +104 -32
  120. package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/hooks/hooks.json +49 -3
  121. package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/scripts/guard-workspace-scope.py +269 -56
  122. package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/scripts/inject-workspace-cwd.py +44 -0
  123. package/.devcontainer/scripts/setup-aliases.sh +13 -5
  124. package/.devcontainer/scripts/setup-config.sh +1 -0
  125. package/README.md +5 -5
  126. package/package.json +6 -2
  127. package/setup.js +3 -2
  128. package/.devcontainer/.env +0 -33
  129. package/.devcontainer/features/README.md +0 -126
  130. package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/.claude-plugin/plugin.json +0 -7
  131. package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/README.md +0 -81
  132. package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/hooks/hooks.json +0 -17
  133. package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/scripts/__pycache__/format-on-stop.cpython-314.pyc +0 -0
  134. package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/scripts/format-on-stop.py +0 -297
  135. package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/.claude-plugin/plugin.json +0 -7
  136. package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/README.md +0 -92
  137. package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/hooks/hooks.json +0 -17
  138. package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/scripts/__pycache__/lint-file.cpython-314.pyc +0 -0
  139. package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/scripts/lint-file.py +0 -536
  140. package/.devcontainer/plugins/devs-marketplace/plugins/dangerous-command-blocker/scripts/__pycache__/block-dangerous.cpython-314.pyc +0 -0
  141. package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/scripts/__pycache__/guard-protected.cpython-314.pyc +0 -0
  142. package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/.claude-plugin/system-prompt.md +0 -184
  143. package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/scripts/__pycache__/guard-workspace-scope.cpython-314.pyc +0 -0
  144. /package/.devcontainer/plugins/devs-marketplace/plugins/agent-system/{.claude-plugin/commands/debug.md → skills/debug/SKILL.md} +0 -0
  145. /package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/{.claude-plugin/commands/ticket/357/200/272create-pr.md" → skills/ticketcreate-pr/SKILL.md} +0 -0
  146. /package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/{.claude-plugin/commands/ticket/357/200/272new.md" → skills/ticketnew/SKILL.md} +0 -0
  147. /package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/{.claude-plugin/commands/ticket/357/200/272review-commit.md" → skills/ticketreview-commit/SKILL.md} +0 -0
  148. /package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/{.claude-plugin/commands/ticket/357/200/272work.md" → skills/ticketwork/SKILL.md} +0 -0
@@ -1,7 +1,11 @@
1
1
  {
2
2
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
3
3
  "name": "devs-marketplace",
4
- "description": "CodeForge plugin marketplace for development tools",
4
+ "metadata": {
5
+ "description": "CodeForge plugin marketplace for development tools",
6
+ "version": "1.0.0",
7
+ "pluginRoot": "./plugins"
8
+ },
5
9
  "owner": {
6
10
  "name": "AnExiledDev"
7
11
  },
@@ -10,125 +14,89 @@
10
14
  "name": "codeforge-lsp",
11
15
  "description": "LSP servers for CodeForge (Python, TypeScript, Go)",
12
16
  "version": "1.0.0",
13
- "source": "./plugins/codeforge-lsp",
17
+ "source": "codeforge-lsp",
14
18
  "category": "development",
15
- "lspServers": {
16
- "pyright": {
17
- "command": "pyright-langserver",
18
- "args": ["--stdio"],
19
- "extensionToLanguage": {
20
- ".py": "python",
21
- ".pyi": "python"
22
- }
23
- },
24
- "typescript": {
25
- "command": "typescript-language-server",
26
- "args": ["--stdio"],
27
- "extensionToLanguage": {
28
- ".ts": "typescript",
29
- ".tsx": "typescriptreact",
30
- ".js": "javascript",
31
- ".jsx": "javascriptreact",
32
- ".mts": "typescript",
33
- ".cts": "typescript",
34
- ".mjs": "javascript",
35
- ".cjs": "javascript"
36
- }
37
- },
38
- "gopls": {
39
- "command": "gopls",
40
- "args": ["serve"],
41
- "extensionToLanguage": {
42
- ".go": "go",
43
- ".mod": "go.mod",
44
- ".sum": "go.sum"
45
- }
46
- }
47
- }
19
+ "keywords": ["lsp", "python", "typescript", "go"]
48
20
  },
49
21
  {
50
22
  "name": "ticket-workflow",
51
23
  "description": "EARS-based ticket workflow with GitHub integration",
52
24
  "version": "1.0.0",
53
- "source": "./plugins/ticket-workflow",
54
- "category": "workflow"
25
+ "source": "ticket-workflow",
26
+ "category": "workflow",
27
+ "keywords": ["tickets", "github", "workflow", "ears", "issues", "pr"]
55
28
  },
56
29
  {
57
30
  "name": "notify-hook",
58
31
  "description": "Desktop notifications and audio chime when Claude finishes responding",
59
32
  "version": "1.0.0",
60
- "source": "./plugins/notify-hook",
61
- "category": "productivity"
33
+ "source": "notify-hook",
34
+ "category": "productivity",
35
+ "keywords": ["notifications", "desktop", "audio"]
62
36
  },
63
37
  {
64
38
  "name": "dangerous-command-blocker",
65
39
  "description": "Blocks dangerous bash commands (rm -rf, sudo rm, chmod 777, force push)",
66
40
  "version": "1.0.0",
67
- "source": "./plugins/dangerous-command-blocker",
68
- "category": "safety"
41
+ "source": "dangerous-command-blocker",
42
+ "category": "safety",
43
+ "keywords": ["safety", "bash", "blocker"]
69
44
  },
70
45
  {
71
46
  "name": "protected-files-guard",
72
47
  "description": "Blocks modifications to .env, lock files, .git/, and credentials",
73
48
  "version": "1.0.0",
74
- "source": "./plugins/protected-files-guard",
75
- "category": "safety"
76
- },
77
- {
78
- "name": "auto-formatter",
79
- "description": "Batch-formats edited files at Stop (Ruff for Python, gofmt for Go, Biome for JS/TS/CSS/JSON/GraphQL/HTML, shfmt for Shell, dprint for Markdown/YAML/TOML/Dockerfile, rustfmt for Rust)",
80
- "version": "1.0.0",
81
- "source": "./plugins/auto-formatter",
82
- "category": "development"
83
- },
84
- {
85
- "name": "auto-linter",
86
- "description": "Auto-lints edited files at Stop (Pyright + Ruff for Python, Biome for JS/TS/CSS/GraphQL, ShellCheck for Shell, go vet for Go, hadolint for Dockerfile, clippy for Rust)",
87
- "version": "1.0.0",
88
- "source": "./plugins/auto-linter",
89
- "category": "development"
49
+ "source": "protected-files-guard",
50
+ "category": "safety",
51
+ "keywords": ["safety", "secrets", "env", "lockfiles"]
90
52
  },
91
53
  {
92
54
  "name": "agent-system",
93
55
  "description": "17 custom agents with built-in agent redirection, CWD injection, and read-only bash enforcement",
94
56
  "version": "1.0.0",
95
- "source": "./plugins/agent-system",
96
- "category": "development"
57
+ "source": "agent-system",
58
+ "category": "development",
59
+ "keywords": ["agents", "subagents", "redirection"]
97
60
  },
98
61
  {
99
62
  "name": "skill-engine",
100
63
  "description": "21 coding knowledge packs with auto-suggestion for frameworks, tools, and patterns",
101
64
  "version": "1.0.0",
102
- "source": "./plugins/skill-engine",
103
- "category": "development"
65
+ "source": "skill-engine",
66
+ "category": "development",
67
+ "keywords": ["skills", "knowledge", "auto-suggestion"]
104
68
  },
105
69
  {
106
70
  "name": "spec-workflow",
107
71
  "description": "Specification lifecycle management: creation, refinement, building, reviewing, updating, and auditing",
108
72
  "version": "1.0.0",
109
- "source": "./plugins/spec-workflow",
110
- "category": "workflow"
73
+ "source": "spec-workflow",
74
+ "category": "workflow",
75
+ "keywords": ["specifications", "lifecycle", "ears"]
111
76
  },
112
77
  {
113
78
  "name": "session-context",
114
79
  "description": "Session lifecycle hooks: git state injection, TODO harvesting, and commit reminders",
115
80
  "version": "1.0.0",
116
- "source": "./plugins/session-context",
117
- "category": "development"
81
+ "source": "session-context",
82
+ "category": "development",
83
+ "keywords": ["session", "git", "todos", "commits"]
118
84
  },
119
85
  {
120
86
  "name": "auto-code-quality",
121
87
  "description": "Self-contained code quality: auto-format + auto-lint edited files (Ruff/Black, Biome, gofmt, shfmt, dprint, rustfmt, Pyright, ShellCheck, go vet, hadolint, clippy)",
122
88
  "version": "1.0.0",
123
- "source": "./plugins/auto-code-quality",
124
- "category": "development"
89
+ "source": "auto-code-quality",
90
+ "category": "development",
91
+ "keywords": ["formatting", "linting", "syntax", "quality"]
125
92
  },
126
93
  {
127
94
  "name": "workspace-scope-guard",
128
95
  "description": "Enforces working directory scope — blocks writes and warns on reads outside the project",
129
96
  "version": "1.0.0",
130
- "source": "./plugins/workspace-scope-guard",
131
- "category": "safety"
97
+ "source": "workspace-scope-guard",
98
+ "category": "safety",
99
+ "keywords": ["safety", "scope", "workspace"]
132
100
  }
133
101
  ]
134
102
  }
@@ -1,7 +1,6 @@
1
1
  {
2
2
  "name": "agent-system",
3
3
  "description": "17 custom agents with built-in agent redirection, CWD injection, and read-only bash enforcement",
4
- "version": "1.0.0",
5
4
  "author": {
6
5
  "name": "AnExiledDev"
7
6
  }
@@ -0,0 +1,197 @@
1
+ # agent-system
2
+
3
+ Claude Code plugin that provides 17 custom specialist agents with automatic built-in agent redirection, working directory injection, read-only bash enforcement, and team quality gates.
4
+
5
+ ## What It Does
6
+
7
+ Replaces Claude Code's built-in agents with enhanced custom agents that carry domain-specific instructions, safety hooks, and tailored tool configurations. Also provides team orchestration quality gates.
8
+
9
+ ### Custom Agents
10
+
11
+ | Agent | Specialty | Access |
12
+ |-------|-----------|--------|
13
+ | architect | Implementation planning, trade-off analysis | Read-only |
14
+ | bash-exec | Terminal command execution | Bash only |
15
+ | claude-guide | Claude Code features, configuration, best practices | Read-only |
16
+ | debug-logs | Log investigation and issue diagnosis | Read-only |
17
+ | dependency-analyst | Outdated/vulnerable dependency analysis | Read-only |
18
+ | doc-writer | READMEs, API docs, usage guides | Full access |
19
+ | explorer | Fast codebase search and structure mapping | Read-only |
20
+ | generalist | General-purpose multi-step tasks | Full access |
21
+ | git-archaeologist | Git history, blame, branch analysis | Read-only |
22
+ | migrator | Framework/version upgrades and migrations | Full access |
23
+ | perf-profiler | Profiling, benchmarks, bottleneck identification | Read-only |
24
+ | refactorer | Safe code transformations with regression testing | Full access |
25
+ | researcher | Web research, technology investigation | Read-only |
26
+ | security-auditor | OWASP audit, secrets scan, vulnerability detection | Read-only |
27
+ | spec-writer | EARS requirements, acceptance criteria, feature specs | Read-only |
28
+ | statusline-config | Claude Code status line configuration | Full access |
29
+ | test-writer | Test suites with auto-verification | Full access |
30
+
31
+ ### Agent Redirection
32
+
33
+ Built-in agent types are transparently redirected to their enhanced custom equivalents:
34
+
35
+ | Built-in Type | Redirects To |
36
+ |---------------|-------------|
37
+ | Explore | explorer |
38
+ | Plan | architect |
39
+ | general-purpose | generalist |
40
+ | Bash | bash-exec |
41
+ | claude-code-guide | claude-guide |
42
+ | statusline-setup | statusline-config |
43
+
44
+ ### Quality Gates
45
+
46
+ | Hook | Script | Purpose |
47
+ |------|--------|---------|
48
+ | TeammateIdle | `teammate-idle-check.py` | Prevents teammates from going idle with incomplete tasks |
49
+ | TaskCompleted | `task-completed-check.py` | Runs test suite before allowing task completion |
50
+
51
+ Per-agent hooks (registered within agent definitions, not in hooks.json):
52
+
53
+ | Agent | Hook | Script | Purpose |
54
+ |-------|------|--------|---------|
55
+ | refactorer | PostToolUse (Edit) | `verify-no-regression.py` | Runs tests after each edit to catch regressions |
56
+ | test-writer | Stop | `verify-tests-pass.py` | Verifies written tests actually pass |
57
+
58
+ ## How It Works
59
+
60
+ ### Hook Lifecycle
61
+
62
+ ```
63
+ Claude calls the Task tool (spawning a subagent)
64
+ |
65
+ +-> PreToolUse/Task fires
66
+ | |
67
+ | +-> redirect-builtin-agents.py
68
+ | |
69
+ | +-> Built-in agent name? -> Rewrite to custom agent
70
+ | +-> Already custom? -> Pass through
71
+ |
72
+ +-> SubagentStart fires (all subagents)
73
+ | |
74
+ | +-> inject-cwd.py
75
+ | |
76
+ | +-> Injects working directory as additionalContext
77
+ |
78
+ +-> Subagent works...
79
+ |
80
+ +-> TaskCompleted fires
81
+ | |
82
+ | +-> task-completed-check.py
83
+ | |
84
+ | +-> Detect test framework -> Run tests
85
+ | +-> Tests pass? -> Allow completion
86
+ | +-> Tests fail? -> Block, send feedback
87
+ |
88
+ +-> TeammateIdle fires (team mode)
89
+ |
90
+ +-> teammate-idle-check.py
91
+ |
92
+ +-> Check task list for incomplete tasks
93
+ +-> Found? -> Send feedback to resume work
94
+ ```
95
+
96
+ ### Read-Only Bash Enforcement
97
+
98
+ Read-only agents (explorer, researcher, architect, etc.) have their Bash access restricted by `guard-readonly-bash.py`. Blocked operations include:
99
+
100
+ - File mutations: `rm`, `mv`, `cp`, `mkdir`, `touch`, `chmod`, `chown`
101
+ - Output redirection: `>`, `>>`, `tee`
102
+ - Command chaining with writes: pipes to destructive commands
103
+ - Eval/exec patterns
104
+
105
+ ### Exit Code Behavior
106
+
107
+ | Script | Exit 0 | Exit 2 |
108
+ |--------|--------|--------|
109
+ | redirect-builtin-agents.py | Allow (or rewrite) | Block with error |
110
+ | inject-cwd.py | Inject context | N/A |
111
+ | guard-readonly-bash.py | Allow command | Block write operation |
112
+ | task-completed-check.py | Tests pass | Tests fail (block completion) |
113
+ | teammate-idle-check.py | No incomplete tasks | Has incomplete tasks |
114
+
115
+ ### Timeouts
116
+
117
+ | Hook | Timeout |
118
+ |------|---------|
119
+ | Agent redirection (PreToolUse) | 5s |
120
+ | CWD injection (SubagentStart) | 3s |
121
+ | Teammate idle check | 10s |
122
+ | Task completed check | 60s |
123
+
124
+ ## Installation
125
+
126
+ ### CodeForge DevContainer
127
+
128
+ Pre-installed and activated automatically — no setup needed.
129
+
130
+ ### From GitHub
131
+
132
+ Use this plugin in any Claude Code setup:
133
+
134
+ 1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
135
+
136
+ ```bash
137
+ git clone https://github.com/AnExiledDev/CodeForge.git
138
+ ```
139
+
140
+ 2. Enable the plugin in your `.claude/settings.json`:
141
+
142
+ ```json
143
+ {
144
+ "enabledPlugins": {
145
+ "agent-system@<clone-path>/.devcontainer/plugins/devs-marketplace": true
146
+ }
147
+ }
148
+ ```
149
+
150
+ Replace `<clone-path>` with the absolute path to your CodeForge clone.
151
+
152
+ ## Plugin Structure
153
+
154
+ ```
155
+ agent-system/
156
+ +-- .claude-plugin/
157
+ | +-- plugin.json # Plugin metadata
158
+ +-- agents/
159
+ | +-- architect.md # 17 agent definition files
160
+ | +-- bash-exec.md
161
+ | +-- claude-guide.md
162
+ | +-- debug-logs.md
163
+ | +-- dependency-analyst.md
164
+ | +-- doc-writer.md
165
+ | +-- explorer.md
166
+ | +-- generalist.md
167
+ | +-- git-archaeologist.md
168
+ | +-- migrator.md
169
+ | +-- perf-profiler.md
170
+ | +-- refactorer.md
171
+ | +-- researcher.md
172
+ | +-- security-auditor.md
173
+ | +-- spec-writer.md
174
+ | +-- statusline-config.md
175
+ | +-- test-writer.md
176
+ +-- hooks/
177
+ | +-- hooks.json # Hook registrations
178
+ +-- scripts/
179
+ | +-- guard-readonly-bash.py # Read-only bash enforcement
180
+ | +-- inject-cwd.py # Working directory injection
181
+ | +-- redirect-builtin-agents.py # Built-in agent redirection
182
+ | +-- task-completed-check.py # Test suite quality gate
183
+ | +-- teammate-idle-check.py # Incomplete task checker
184
+ | +-- verify-no-regression.py # Post-edit regression tests (refactorer)
185
+ | +-- verify-tests-pass.py # Test verification (test-writer)
186
+ +-- skills/
187
+ | +-- debug/
188
+ | +-- SKILL.md # Structured log investigation skill
189
+ +-- AGENT-REDIRECTION.md # Redirection mechanism docs
190
+ +-- REVIEW-RUBRIC.md # Agent/skill quality rubric
191
+ +-- README.md # This file
192
+ ```
193
+
194
+ ## Requirements
195
+
196
+ - Python 3.11+
197
+ - Claude Code with plugin hook support (agents, hooks, skills)
@@ -7,10 +7,12 @@ description: >-
7
7
  "how should we architect", "what's the best strategy for", "create an
8
8
  implementation plan", or needs step-by-step plans, dependency analysis,
9
9
  risk assessment, or architectural decision-making. Returns structured
10
- plans with critical file paths and never modifies any files.
10
+ plans with critical file paths and never modifies any files. Do not
11
+ use for implementation, code generation, or file modifications.
11
12
  tools: Read, Glob, Grep, Bash, WebSearch, WebFetch
12
13
  model: opus
13
14
  color: magenta
15
+ permissionMode: plan
14
16
  memory:
15
17
  scope: project
16
18
  skills:
@@ -6,9 +6,12 @@ description: >-
6
6
  execution, process management, or any terminal task. Follows git safety
7
7
  protocols, quotes paths with spaces, and reports command output clearly.
8
8
  Has only the Bash tool — no file reading or searching capabilities.
9
+ Do not use for file reading, code search, or tasks requiring file
10
+ content analysis.
9
11
  tools: Bash
10
12
  model: sonnet
11
13
  color: yellow
14
+ permissionMode: default
12
15
  memory:
13
16
  scope: project
14
17
  ---
@@ -9,10 +9,13 @@ description: >-
9
9
  on Claude Code features, hooks, slash commands, skills, plugins, IDE
10
10
  integrations, keyboard shortcuts, Agent SDK setup, or API usage. Before
11
11
  spawning a new instance, check if there is already a running or recently
12
- completed claude-guide agent that you can resume using the "resume" parameter.
12
+ completed claude-guide agent that you can resume using the "resume"
13
+ parameter. Do not use for code implementation, file modifications, or
14
+ questions unrelated to Claude Code, Agent SDK, or the Claude API.
13
15
  tools: Glob, Grep, Read, WebFetch, WebSearch
14
16
  model: haiku
15
17
  color: cyan
18
+ permissionMode: plan
16
19
  memory:
17
20
  scope: user
18
21
  skills:
@@ -3,10 +3,15 @@ name: debug-logs
3
3
  description: >-
4
4
  Read-only agent that finds and analyzes log files across Docker containers,
5
5
  application frameworks, and system services to identify errors, crashes,
6
- and performance issues. Reports structured findings with root cause assessment.
6
+ and performance issues. Reports structured findings with root cause
7
+ assessment. Do not use for fixing issues, modifying code, or
8
+ application-level debugging — log analysis and diagnosis only.
7
9
  tools: Bash, Read, Glob, Grep
8
10
  model: sonnet
9
11
  color: red
12
+ permissionMode: plan
13
+ memory:
14
+ scope: project
10
15
  skills:
11
16
  - debugging
12
17
  ---
@@ -8,10 +8,14 @@ description: >-
8
8
  packages", "audit dependencies", "check dependency health", "license check",
9
9
  "are my dependencies up to date", "npm audit", "pip audit", or needs any
10
10
  dependency analysis across Node.js, Python, Rust, or Go ecosystems.
11
- Reports findings without modifying any files.
11
+ Reports findings without modifying any files. Do not use for
12
+ installing, upgrading, or modifying dependencies — analysis and
13
+ advisory reporting only.
12
14
  tools: Read, Bash, Glob, Grep
13
15
  model: haiku
14
16
  color: blue
17
+ permissionMode: plan
18
+ background: true
15
19
  memory:
16
20
  scope: project
17
21
  skills:
@@ -7,10 +7,13 @@ description: >-
7
7
  "write a README", "document this", "add docstrings", "add JSDoc", "update
8
8
  the docs", "write API documentation", "create architecture docs", "document
9
9
  these functions", or needs any form of code documentation, inline comments,
10
- or technical writing.
10
+ or technical writing. Do not use for modifying source code logic,
11
+ fixing bugs, or feature implementation.
11
12
  tools: Read, Edit, Glob, Grep
12
13
  model: opus
13
14
  color: cyan
15
+ permissionMode: acceptEdits
16
+ isolation: worktree
14
17
  memory:
15
18
  scope: project
16
19
  skills:
@@ -8,10 +8,12 @@ description: >-
8
8
  "what files contain", or needs quick file discovery, pattern matching,
9
9
  or codebase navigation. Supports thoroughness levels: quick, medium,
10
10
  very thorough. Reports findings with absolute file paths and never
11
- modifies any files.
11
+ modifies any files. Do not use for code modifications, multi-step
12
+ research requiring web access, or implementation tasks.
12
13
  tools: Read, Glob, Grep, Bash
13
14
  model: haiku
14
15
  color: blue
16
+ permissionMode: plan
15
17
  memory:
16
18
  scope: project
17
19
  skills:
@@ -6,10 +6,18 @@ description: >-
6
6
  the user needs a keyword or file search that may require multiple attempts,
7
7
  multi-file investigation, code modifications across several files, or
8
8
  any complex task that doesn't fit a specialist agent's domain. Has access
9
- to all tools and can both read and write files.
9
+ to all tools and can both read and write files. Do not use when a
10
+ specialist agent clearly matches the task — prefer the domain
11
+ specialist for better results.
10
12
  tools: "*"
13
+ disallowedTools:
14
+ - EnterPlanMode
15
+ - EnterWorktree
16
+ - TeamCreate
17
+ - TeamDelete
11
18
  model: inherit
12
19
  color: green
20
+ permissionMode: default
13
21
  memory:
14
22
  scope: project
15
23
  skills:
@@ -8,9 +8,12 @@ description: >-
8
8
  "git blame", "git bisect", "what happened to this code", "show the history
9
9
  of this file", "who contributed to this module", "recover lost commit",
10
10
  "trace this function's evolution", or needs any git history forensics.
11
+ Do not use for modifying git history, making commits, pushing, or any
12
+ git write operations.
11
13
  tools: Read, Grep, Bash
12
14
  model: haiku
13
15
  color: blue
16
+ permissionMode: plan
14
17
  memory:
15
18
  scope: project
16
19
  skills:
@@ -8,10 +8,13 @@ description: >-
8
8
  "update the framework", "bump Python version", "convert from Express to
9
9
  Fastify", "upgrade Pydantic", "modernize the codebase", or needs any
10
10
  framework, library, or language version migration with step-by-step
11
- verification.
11
+ verification. Do not use for new feature development, bug fixes, or
12
+ changes unrelated to version or framework migration.
12
13
  tools: Read, Edit, Write, Glob, Grep, Bash, WebFetch
13
14
  model: opus
14
15
  color: magenta
16
+ permissionMode: acceptEdits
17
+ isolation: worktree
15
18
  memory:
16
19
  scope: user
17
20
  skills:
@@ -8,10 +8,13 @@ description: >-
8
8
  "measure performance", "optimize the build", "check response times",
9
9
  "profile the database queries", "find memory leaks", or needs any
10
10
  performance measurement, bottleneck identification, or optimization
11
- guidance backed by profiling data.
11
+ guidance backed by profiling data. Do not use for implementing
12
+ optimizations or modifying code — measurement and analysis only.
12
13
  tools: Read, Bash, Glob, Grep
13
14
  model: sonnet
14
15
  color: yellow
16
+ permissionMode: plan
17
+ background: true
15
18
  memory:
16
19
  scope: project
17
20
  skills:
@@ -7,10 +7,14 @@ description: >-
7
7
  asks "refactor this", "clean up this code", "reduce complexity", "split this
8
8
  class", "extract this function", "remove duplication", "simplify this module",
9
9
  or discusses code smells, technical debt, or structural improvements.
10
- Runs tests after every edit to guarantee safety.
10
+ Runs tests after every edit to guarantee safety. Do not use for
11
+ adding new features, fixing bugs, or making behavioral changes to
12
+ code.
11
13
  tools: Read, Edit, Glob, Grep, Bash
12
14
  model: opus
13
15
  color: yellow
16
+ permissionMode: acceptEdits
17
+ isolation: worktree
14
18
  memory:
15
19
  scope: project
16
20
  skills:
@@ -7,12 +7,16 @@ description: >-
7
7
  approach for", "investigate this", "research", "look into", "compare X vs Y",
8
8
  "explain this concept", or needs codebase analysis, library evaluation,
9
9
  technology comparison, or technical deep-dives. Reports structured findings
10
- with citations without modifying any files.
10
+ with citations without modifying any files. Do not use for code
11
+ modifications, file writing, or implementation tasks.
11
12
  tools: Read, Glob, Grep, WebSearch, WebFetch, Bash
12
13
  model: sonnet
13
14
  color: cyan
15
+ permissionMode: plan
14
16
  memory:
15
17
  scope: user
18
+ skills:
19
+ - documentation-patterns
16
20
  ---
17
21
 
18
22
  # Research Agent
@@ -8,10 +8,13 @@ description: >-
8
8
  "find hardcoded credentials", "check dependency vulnerabilities", "OWASP
9
9
  review", "security check", or needs a security assessment of any code.
10
10
  Reports findings with severity ratings and remediation guidance without
11
- modifying any files.
11
+ modifying any files. Do not use for fixing vulnerabilities or
12
+ implementing security changes — audit and reporting only.
12
13
  tools: Read, Glob, Grep, Bash
13
14
  model: sonnet
14
15
  color: red
16
+ permissionMode: plan
17
+ background: true
15
18
  memory:
16
19
  scope: user
17
20
  skills:
@@ -8,10 +8,12 @@ description: >-
8
8
  "spec this feature", "write user stories", "define the behavior of",
9
9
  "create a technical specification", or needs structured requirements,
10
10
  acceptance criteria, or feature specifications grounded in the actual
11
- codebase state.
11
+ codebase state. Do not use for code implementation or writing
12
+ executable code — specification authoring only.
12
13
  tools: Read, Glob, Grep, WebSearch
13
14
  model: opus
14
15
  color: magenta
16
+ permissionMode: plan
15
17
  memory:
16
18
  scope: user
17
19
  skills:
@@ -5,10 +5,13 @@ description: >-
5
5
  status line setting. Use when the user asks "set up my status line", "convert
6
6
  my PS1", "customize the status bar", "show git branch in status line",
7
7
  "add context usage to status line", or wants to configure what appears in
8
- Claude Code's bottom status bar. Can read shell configs and write settings.
8
+ Claude Code's bottom status bar. Can read shell configs and write
9
+ settings. Do not use for general Claude Code settings, non-status-line
10
+ configuration, or shell profile modifications.
9
11
  tools: Read, Edit
10
12
  model: sonnet
11
13
  color: orange
14
+ permissionMode: acceptEdits
12
15
  memory:
13
16
  scope: user
14
17
  ---
@@ -7,10 +7,13 @@ description: >-
7
7
  "write tests for", "add tests", "increase test coverage", "create unit tests",
8
8
  "add integration tests", "test this function", "test this module", or needs
9
9
  automated test coverage for any code. Supports pytest, Vitest, Jest, Go
10
- testing, and Rust test frameworks.
10
+ testing, and Rust test frameworks. Do not use for modifying
11
+ application source code, fixing bugs, or implementing features.
11
12
  tools: Read, Write, Edit, Glob, Grep, Bash
12
13
  model: opus
13
14
  color: green
15
+ permissionMode: acceptEdits
16
+ isolation: worktree
14
17
  memory:
15
18
  scope: project
16
19
  skills: