Skip to content

Commit 38b2c90

Browse files
authored
Fix docs accuracy: counts, versions, LSP, factual errors across 45 files (#66)
Full documentation audit found ~65 issues. Key fixes: - Version: standardize to 2.1.0 (2.1.1 never released), merge changelogs - LSP: disable by default (version: "none", plugin: false) - Agent count: 21→19 (remove phantom doc-writer/tester, add investigator/implementer) - Skill count: 38→34 (spec-workflow 8→3 post-v2.1.0 consolidation) - Plugin count: fix inconsistencies (17 total = 13 local + 4 Anthropic) - Remove fabricated inject-cwd.py/SubagentStart hook from agent-system docs - Fix commit-reminder: blocking→advisory, add collect-session-edits hook - Fix dangerous-command-blocker: remove non-existent patterns, fix fail-safe - Fix enabledPlugins format (array→object), config values, port labels - Expand optional-features.md (1→9 documented opt-in features) - Add codeforge proxy, cc-orc, dbr, ccstatusline to tools docs - Add disabled-hooks.json documentation to hooks and optional-features - Add orchestrator system prompt to system-prompts docs - Fix ccms→codeforge session search in rules and prompt-snippets Co-authored-by: AnExiledDev <AnExiledDev@users.noreply.github.com>
1 parent 681d346 commit 38b2c90

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+511
-274
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Monorepo for CodeForge — an AI-powered development environment for Claude Code
66

77
| Package | Description | Version |
88
|---------|-------------|---------|
9-
| [`container/`](container/) | CodeForge DevContainer (`codeforge-dev` on npm) | 2.0.0 |
9+
| [`container/`](container/) | CodeForge DevContainer (`codeforge-dev` on npm) | 2.1.0 |
1010
| [`cli/`](cli/) | CodeForge CLI (`codeforge-cli`) | 0.1.0 |
1111
| [`dashboard/`](dashboard/) | Session analytics dashboard (Svelte 5 SPA + Bun backend) ||
1212
| [`docs/`](docs/) | Documentation site ([codeforge.core-directive.com](https://codeforge.core-directive.com)) ||

cli/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
CLI for CodeForge development workflows. Manages sessions, plugins, configuration, codebase indexing, and devcontainers.
44

5-
> **Experimental** — v0.1.0. Ships with CodeForge v2.1.1.
5+
> **Experimental** — v0.1.0. Ships with CodeForge v2.1.0.
66
77
## Install
88

container/.codeforge/config/settings.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@
6060
"code-review@anthropics/claude-code": true,
6161
"feature-dev@anthropics/claude-code": true,
6262
"pr-review-toolkit@anthropics/claude-code": true,
63-
"codeforge-lsp@devs-marketplace": true,
63+
"codeforge-lsp@devs-marketplace": false,
6464
"ticket-workflow@devs-marketplace": true,
6565
"notify-hook@devs-marketplace": true,
6666
"dangerous-command-blocker@devs-marketplace": true,

container/.devcontainer/CHANGELOG.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,9 @@
2222

2323
### Scope Guard
2424

25+
- Fix `/dev/null` false positive — redirects to system paths (`/dev/`, `/proc/`, `/sys/`, etc.) are now allowed regardless of the primary command, not just for system commands like `git` or `pip`
26+
- Fix CWD drift — scope root is now persisted on first invocation per session, preventing `cd` commands in Bash from silently changing the enforced scope boundary
27+
- CWD context injector now uses the same persisted scope root, keeping advisory context aligned with enforcement
2528
- Fix false positives blocking writes to system paths (`/dev/null`, `/usr/`, `/etc/`, `$HOME/`) — scope guard now only enforces isolation between workspace projects
2629
- Remove complex system-command exemption logic (no longer needed)
2730

@@ -76,14 +79,6 @@
7679
- Dedicated port forwarding reference page covering VS Code auto-detect, devcontainer-bridge, and SSH tunneling
7780
- Document `${CLAUDE_PLUGIN_DATA}` variable in CLAUDE.md for future plugin persistent storage
7881

79-
## v2.1.1 — 2026-03-13
80-
81-
### Workspace Scope Guard
82-
83-
- Fix `/dev/null` false positive — redirects to system paths (`/dev/`, `/proc/`, `/sys/`, etc.) are now allowed regardless of the primary command, not just for system commands like `git` or `pip`
84-
- Fix CWD drift — scope root is now persisted on first invocation per session, preventing `cd` commands in Bash from silently changing the enforced scope boundary
85-
- CWD context injector now uses the same persisted scope root, keeping advisory context aligned with enforcement
86-
8782
## v2.1.0 — 2026-03-13
8883

8984
### Spec Workflow v2 — "Spec Packages"

container/.devcontainer/CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Config files deploy via `.codeforge/file-manifest.json` on every container start
3939

4040
Declared in `settings.json` under `enabledPlugins`, auto-activated on start:
4141

42-
- **agent-system**21 custom agents (4 workhorse + 17 specialist) + built-in agent redirection
42+
- **agent-system**19 custom agents + built-in agent redirection
4343
- **skill-engine** — 23 general coding skills + auto-suggestion
4444
- **spec-workflow** — 3 spec lifecycle skills (`/spec`, `/build`, `/specs`) + spec-reminder hook
4545
- **session-context** — Git state injection, TODO harvesting, commit reminders

container/.devcontainer/devcontainer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@
131131
// },
132132
"./features/ast-grep": {},
133133
"./features/tree-sitter": {},
134-
"./features/lsp-servers": {},
134+
"./features/lsp-servers": { "version": "none" },
135135
"./features/agent-browser": {},
136136
"./features/kitty-terminfo": {},
137137
"./features/chromaterm": {

container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "agent-system",
3-
"description": "17 custom agents with built-in agent redirection, CWD injection, and read-only bash enforcement",
3+
"description": "19 custom agents with built-in agent redirection, CWD injection, and read-only bash enforcement",
44
"author": {
55
"name": "AnExiledDev"
66
}

container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/AGENT-REDIRECTION.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,6 @@ agent-system/
207207
│ └── hooks.json # Hook registrations
208208
└── scripts/
209209
├── redirect-builtin-agents.py # The redirection hook
210-
├── inject-cwd.py # CWD injection for subagents
211210
└── guard-readonly-bash.py # Read-only bash enforcement
212211
```
213212

container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/README.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -81,12 +81,6 @@ Claude calls the Task tool (spawning a subagent)
8181
| +-> Built-in agent name? -> Rewrite to custom agent
8282
| +-> Already custom? -> Pass through
8383
|
84-
+-> SubagentStart fires (all subagents)
85-
| |
86-
| +-> inject-cwd.py
87-
| |
88-
| +-> Injects working directory as additionalContext
89-
|
9084
+-> Subagent works...
9185
|
9286
+-> TaskCompleted fires
@@ -119,7 +113,6 @@ Read-only agents (explorer, researcher, architect, etc.) have their Bash access
119113
| Script | Exit 0 | Exit 2 |
120114
|--------|--------|--------|
121115
| redirect-builtin-agents.py | Allow (or rewrite) | Block with error |
122-
| inject-cwd.py | Inject context | N/A |
123116
| guard-readonly-bash.py | Allow command | Block write operation |
124117
| task-completed-check.py | Tests pass | Tests fail (block completion) |
125118
| teammate-idle-check.py | No incomplete tasks | Has incomplete tasks |

container/README.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -83,9 +83,9 @@ tree-sitter (JS/TS/Python), ast-grep, Pyright, TypeScript LSP
8383

8484
tmux, agent-browser, claude-monitor, ccusage, ccburn, ccstatusline, ast-grep, tree-sitter, lsp-servers, biome, ruff, shfmt, shellcheck, hadolint, dprint, ccms, notify-hook, mcp-qdrant, chromaterm, kitty-terminfo, claude-session-dashboard
8585

86-
### Agents (17) & Skills (35)
86+
### Agents (19) & Skills (34)
8787

88-
The `agent-system` plugin includes 17 specialized agents (architect, explorer, test-writer, security-auditor, etc.). The `skill-engine` plugin provides 23 general coding skills, `spec-workflow` adds 8 spec lifecycle skills, and `ticket-workflow` provides 4 ticket management skills.
88+
The `agent-system` plugin includes 19 specialized agents (architect, explorer, test-writer, security-auditor, etc.). The `skill-engine` plugin provides 23 general coding skills, `spec-workflow` adds 3 spec lifecycle skills, and `ticket-workflow` provides 4 ticket management skills. 4 plugins are official Anthropic contributions.
8989

9090
## Architecture
9191

@@ -106,7 +106,7 @@ CodeForge operates in three layers, each building on the one below:
106106

107107
**DevContainer** — The foundation. A Python 3.14 container with Node.js, Rust, and Bun runtimes, plus 23 custom features that install development tools (ast-grep, tree-sitter, biome, ruff, and others).
108108

109-
**CodeForge Layer** — The intelligence. 17 plugins register hooks that validate commands, inject context, and enforce safety. 21 agents provide specialized personas. 38 skills offer on-demand reference material. System prompts and rules shape behavior.
109+
**CodeForge Layer** — The intelligence. 17 plugins register hooks that validate commands, inject context, and enforce safety. 19 agents provide specialized personas. 34 skills offer on-demand reference material. System prompts and rules shape behavior.
110110

111111
**Claude Code** — The AI assistant, executing tools and coordinating work. CodeForge enhances it through configuration — replacing built-in subagents, adding safety guardrails, and wiring up quality checks that run automatically.
112112

@@ -118,11 +118,11 @@ All configuration lives in `.devcontainer/` and deploys automatically on contain
118118

119119
| File | What It Configures | User-Modifiable? |
120120
|------|--------------------|------------------|
121-
| `config/defaults/settings.json` | Model, plugins, permissions, environment variables | Yes |
122-
| `config/defaults/main-system-prompt.md` | Claude's behavioral guidelines and directives | Yes |
123-
| `config/defaults/keybindings.json` | Keyboard shortcuts | Yes |
124-
| `config/defaults/ccstatusline-settings.json` | Terminal status bar widgets and layout | Yes |
125-
| `config/file-manifest.json` | Which config files deploy and how they update | Yes |
121+
| `.codeforge/config/settings.json` | Model, plugins, permissions, environment variables | Yes |
122+
| `.codeforge/config/main-system-prompt.md` | Claude's behavioral guidelines and directives | Yes |
123+
| `.codeforge/config/keybindings.json` | Keyboard shortcuts | Yes |
124+
| `.codeforge/config/ccstatusline-settings.json` | Terminal status bar widgets and layout | Yes |
125+
| `.codeforge/file-manifest.json` | Which config files deploy and how they update | Yes |
126126
| `devcontainer.json` | Container image, features, runtimes, ports | Yes |
127127
| `.env` | Setup phase toggles (auth, plugins, aliases, etc.) | Yes |
128128

@@ -177,7 +177,7 @@ npm publish
177177

178178
## Changelog
179179

180-
See [CHANGELOG.md](.devcontainer/CHANGELOG.md) for release history. Current version: **2.0.0**.
180+
See [CHANGELOG.md](.devcontainer/CHANGELOG.md) for release history. Current version: **2.1.0**.
181181

182182
## Further Reading
183183

0 commit comments

Comments
 (0)