docs(audit): D1+D5 — symlink note + remove /self-improve phantom reference#1156
Open
akaszubski wants to merge 1 commit into
Open
docs(audit): D1+D5 — symlink note + remove /self-improve phantom reference#1156akaszubski wants to merge 1 commit into
akaszubski wants to merge 1 commit into
Conversation
…rence Two cleanup items from the 2026-06-06 state audit (docs/audits/20260606-state-audit.md): D1 — Document that .claude/PROJECT.md is a symlink (git mode 120000) to the repo-root canonical PROJECT.md. Audit flagged it as potential duplication; plan-critic confirmed it is intentional (Python-import compatibility shim per worktree_manager.py:286-287). One-line note added to docs/development/CONTENT_ALLOCATION.md so future contributors do not "fix" the symlink by replacing it with a copy. D5 — PROJECT.md:96 referenced a "/self-improve" command that does not exist (verified by glob commands/self*.md). Phantom scope is worse than missing scope. Reworded the Autonomous Self-Improvement layer to name what IS shipped: continuous-improvement-analyst agent + /improve --auto-file + /triage --auto-improvement. Issues #579-#584 still tracked. The originally-named /self-improve is explicitly noted as never built. Plan-critic verdict on the audit suggestions: D1 + D5 both PROCEED on round 1. The other four (D2 sessions_v2, D3 COMMANDS.md, D4 spec- validator STEP_ORDER, D6 component counts) were REVISE with specific fixes; tracked separately. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two cleanup items from the 2026-06-06 state audit (
docs/audits/20260606-state-audit.md). Both passed plan-critic round 1 as PROCEED.D1 — Symlink documentation
.claude/PROJECT.mdis a symlink (git mode120000) to the repo-root canonicalPROJECT.md. The audit researcher flagged it as potential duplication. Plan-critic verified it is intentional (Python-import compatibility shim perworktree_manager.py:286-287). One-line note added todocs/development/CONTENT_ALLOCATION.mdso future contributors don't "fix" the symlink by replacing it with a copy.D5 — Remove
/self-improvephantom referencePROJECT.md:96referenced a/self-improvecommand that does not exist (verified byglob plugins/autonomous-dev/commands/self*.mdreturning nothing). Phantom scope is worse than missing scope. Reworded to name what IS shipped:continuous-improvement-analystagent +/improve --auto-file+/triage --auto-improvement. Issues #579-#584 still referenced.Tracked separately (REVISE per plan-critic)
pipeline_intent_validator.py::STEP_ORDER(correct slot is 5.7 or 5.8 — 5.5 already taken by pytest-gate)claude_mdfixture intest_documentation_congruence.py)Test plan
PROJECT.mdchange is doc-only, no behavioural impactCONTENT_ALLOCATION.mdtable addition renders correctly as Markdown.claude/PROJECT.mdsymlink still resolves after merge🤖 Generated with Claude Code