|
22 | 22 | - Updated Bun feature to install latest version (was pinned to outdated 1.3.9) |
23 | 23 | - Added npm cache cleanup to 6 features: agent-browser, ast-grep, biome, claude-session-dashboard, lsp-servers, tree-sitter (saves ~96 MB runtime disk) |
24 | 24 |
|
| 25 | +#### System Prompts |
| 26 | +- **Main system prompt redesigned** — reorganized from 672 to 462 lines with new section order prioritizing personality, core directives, and response guidelines at the top |
| 27 | +- **Added personality section** — defines communication style (casual-professional, direct, terse), humor rules, honesty approach, AuDHD-aware patterns, and good/bad response examples; replaces the empty `<identity>` tag |
| 28 | +- **Compressed specification management** — reduced from 98 to 28 lines; full template and enforcement workflow moved to loadable skills |
| 29 | +- **Compressed code standards** — removed textbook principle recitations (SOLID, DRY/KISS/YAGNI by name); kept only concrete actionable rules |
| 30 | +- **Removed browser automation section** — moved to loadable skill (relevant in <10% of sessions) |
| 31 | +- **Removed git worktrees section** — moved to loadable skill; EnterWorktree and `--worktree` flag documented in CLAUDE.md |
| 32 | +- **Added context-passing protocol** to orchestration — mandatory instructions for including gathered context, file paths, and constraints when spawning subagents |
| 33 | +- **Absorbed `<assumption_surfacing>` into `<core_directives>`** — key rules preserved, wrapper removed |
| 34 | +- **Absorbed `<professional_objectivity>` into `<personality>`** — technical accuracy stance woven into personality definition |
| 35 | +- **Deduplicated team composition examples** — consolidated into orchestration section only |
| 36 | +- **Consolidated "no filler" instructions** — previously stated three different ways across three sections |
| 37 | + |
| 38 | +#### Agent System |
| 39 | +- **All 21 agents now have communication protocols** — read-only agents get "Handling Uncertainty" (make best judgment, flag assumptions); write-capable agents get "Question Surfacing Protocol" (BLOCKED + return for ambiguity) |
| 40 | +- **Architect agent: anti-fluff enforcement** — explicit banned patterns ("This approach follows best practices...", restating the problem, explaining why the approach is good), good/bad plan line examples |
| 41 | +- **Architect agent: team orchestration planning** — can now plan teammate composition, file ownership, task dependencies, and worktree usage when tasks warrant parallel work |
| 42 | +- **Architect agent: strengthened output format** — team plan section added, edit ordering section added, file references must be specific |
| 43 | +- **Generalist agent rewritten as last-resort** — description changed to "LAST RESORT agent. Only use when NO specialist agent matches", identity paragraph flags when a specialist might have been better |
| 44 | +- **Investigator agent: structured output guidance** — added instruction to include actionable next steps, not just observations |
| 45 | +- **Added Bash guard hooks** to researcher, debug-logs, and perf-profiler agents — prevents accidental state-changing commands in read-only agents |
| 46 | +- **Architect agent: major plan quality improvements** — complexity scaling framework (simple/moderate/complex), 20+ banned fluff patterns, concrete edit ordering (Models→Services→Routes→Tests→Config), rollback strategy requirement for schema/API changes, schema change detection, verification criteria per phase, 3 new examples (migration, multi-agent refactoring, ambiguous requirement) |
| 47 | +- **Merged tester agent into test-writer** — test-writer is now the single test agent; tester.md removed (test-writer was more comprehensive with better examples and Question Surfacing Protocol) |
| 48 | +- **Merged doc-writer agent into documenter** — documenter is now the single documentation agent with full spec lifecycle AND rich documentation patterns (README 5-question structure, API docs format, language-specific docstring examples, architectural docs, style guide); doc-writer.md removed |
| 49 | +- **Narrowed investigator description** — repositioned from catch-all "all read-only analysis" to "cross-domain investigations spanning 2+ specialist areas"; prevents over-selection when a focused specialist (explorer, researcher, git-archaeologist, etc.) is the better fit |
| 50 | +- **Improved agent descriptions for routing accuracy** — added missing trigger phrases to explorer, researcher, debug-logs, dependency-analyst, security-auditor, perf-profiler, refactorer, and test-writer; clarified overlap boundaries between security-auditor (code-level) and dependency-analyst (package-level), explorer (codebase-only) and researcher (web+code) |
| 51 | +- **Resolved communication protocol contradictions** — aligned all "ask the user/caller" instructions in agent behavioral rules with the new Handling Uncertainty / Question Surfacing Protocol sections, eliminating conflicting guidance about direct user interaction |
| 52 | + |
| 53 | +#### Skill Engine: Auto-Suggestion |
| 54 | +- **Weighted scoring** — Skill suggestion phrases now carry confidence weights (0.0–1.0) instead of binary match/no-match. Specific phrases like "build a fastapi app" score 1.0; ambiguous phrases like "start building" score 0.2 |
| 55 | +- **Negative patterns** — Skills can define substrings that instantly disqualify them. Prevents `fastapi` from triggering when discussing `pydantic-ai`, and `docker` from triggering for `docker-py` prompts |
| 56 | +- **Context guards** — Low-confidence matches (score < 0.6) require a confirming context word elsewhere in the prompt. "health check" only suggests `docker` if "docker", "container", or "compose" also appears |
| 57 | +- **Ranked results, capped at 3** — Suggestions are sorted by score (then priority tier), and only the top 3 are returned. Eliminates 6+ skill suggestion floods |
| 58 | +- **Priority tiers** — Explicit commands (priority 10) outrank technology skills (7), which outrank patterns (5) and generic skills (3) when scores tie |
| 59 | + |
| 60 | +#### Claude Code Installation |
| 61 | +- **Claude Code now installs as a native binary** — uses Anthropic's official installer (`https://claude.ai/install.sh`) via new `./features/claude-code-native` feature, replacing the npm-based `ghcr.io/anthropics/devcontainer-features/claude-code:1.0.5` |
| 62 | +- **In-session auto-updater now works without root** — native binary at `~/.local/bin/claude` is owned by the container user, so `claude update` succeeds without permission issues |
| 63 | + |
| 64 | +#### System Prompt |
| 65 | +- **`<git_worktrees>` section** — Updated to document Claude Code native worktree convention (`<repo>/.claude/worktrees/`) as the recommended approach alongside the legacy `.worktrees/` convention. Added `EnterWorktree` tool guidance, `.worktreeinclude` file documentation, and path convention comparison table. |
| 66 | + |
| 67 | +#### Configuration |
| 68 | +- Moved `.claude` directory from `/workspaces/.claude` to `~/.claude` (home directory) |
| 69 | +- Added Docker named volume for persistence across rebuilds (per-instance isolation via `${devcontainerId}`) |
| 70 | +- `CLAUDE_CONFIG_DIR` now defaults to `~/.claude` |
| 71 | +- `file-manifest.json` — added deployment entry for `orchestrator-system-prompt.md` |
| 72 | +- `setup-aliases.sh` — added `cc-orc` alias alongside existing `cc`, `claude`, `ccw`, `ccraw` |
| 73 | +- `CLAUDE.md` — documented `cc-orc` command and orchestrator system prompt in key configuration table |
| 74 | + |
| 75 | +#### Agent System (previous) |
| 76 | +- Agent count increased from 17 to 21 (4 workhorse + 17 specialist) |
| 77 | +- Agent-system README updated with workhorse agent table, per-agent hooks for implementer and tester, and updated plugin structure |
| 78 | + |
25 | 79 | #### Port Forwarding |
26 | 80 | - Dynamic port forwarding for all ports in VS Code — previously only port 7847 was statically forwarded; now all ports auto-forward with notification |
27 | 81 |
|
|
169 | 223 | - **`documenter`** — consolidated documentation and specification agent (opus) merging doc-writer and spec-writer; handles README, API docs, docstrings, and the full spec lifecycle (create, refine, build, review, update, check) |
170 | 224 | - **Question Surfacing Protocol** — all 4 workhorse agents carry an identical protocol requiring them to STOP and return `## BLOCKED: Questions` sections when hitting ambiguities, ensuring no assumptions are made without user input |
171 | 225 |
|
172 | | -### Changed |
173 | | - |
174 | | -#### Skill Engine: Auto-Suggestion |
175 | | -- **Weighted scoring** — Skill suggestion phrases now carry confidence weights (0.0–1.0) instead of binary match/no-match. Specific phrases like "build a fastapi app" score 1.0; ambiguous phrases like "start building" score 0.2 |
176 | | -- **Negative patterns** — Skills can define substrings that instantly disqualify them. Prevents `fastapi` from triggering when discussing `pydantic-ai`, and `docker` from triggering for `docker-py` prompts |
177 | | -- **Context guards** — Low-confidence matches (score < 0.6) require a confirming context word elsewhere in the prompt. "health check" only suggests `docker` if "docker", "container", or "compose" also appears |
178 | | -- **Ranked results, capped at 3** — Suggestions are sorted by score (then priority tier), and only the top 3 are returned. Eliminates 6+ skill suggestion floods |
179 | | -- **Priority tiers** — Explicit commands (priority 10) outrank technology skills (7), which outrank patterns (5) and generic skills (3) when scores tie |
180 | | - |
181 | | -#### Claude Code Installation |
182 | | -- **Claude Code now installs as a native binary** — uses Anthropic's official installer (`https://claude.ai/install.sh`) via new `./features/claude-code-native` feature, replacing the npm-based `ghcr.io/anthropics/devcontainer-features/claude-code:1.0.5` |
183 | | -- **In-session auto-updater now works without root** — native binary at `~/.local/bin/claude` is owned by the container user, so `claude update` succeeds without permission issues |
184 | | - |
185 | | -#### System Prompt |
186 | | -- **`<git_worktrees>` section** — Updated to document Claude Code native worktree convention (`<repo>/.claude/worktrees/`) as the recommended approach alongside the legacy `.worktrees/` convention. Added `EnterWorktree` tool guidance, `.worktreeinclude` file documentation, and path convention comparison table. |
187 | | - |
188 | | -#### Configuration |
189 | | -- Moved `.claude` directory from `/workspaces/.claude` to `~/.claude` (home directory) |
190 | | -- Added Docker named volume for persistence across rebuilds (per-instance isolation via `${devcontainerId}`) |
191 | | -- `CLAUDE_CONFIG_DIR` now defaults to `~/.claude` |
192 | | -- `file-manifest.json` — added deployment entry for `orchestrator-system-prompt.md` |
193 | | -- `setup-aliases.sh` — added `cc-orc` alias alongside existing `cc`, `claude`, `ccw`, `ccraw` |
194 | | -- `CLAUDE.md` — documented `cc-orc` command and orchestrator system prompt in key configuration table |
195 | | - |
196 | | -#### Agent System |
197 | | -- Agent count increased from 17 to 21 (4 workhorse + 17 specialist) |
198 | | -- Agent-system README updated with workhorse agent table, per-agent hooks for implementer and tester, and updated plugin structure |
199 | | - |
200 | 226 | #### Authentication |
201 | 227 | - Added `CLAUDE_AUTH_TOKEN` support in `.secrets` for long-lived tokens from `claude setup-token` |
202 | 228 | - Auto-creates `.credentials.json` from token on container start (skips if already exists) |
|
0 commit comments