From cdea4e369ab1b391ddfe53b2066002866f9056ea Mon Sep 17 00:00:00 2001 From: Jason Mulligan Date: Wed, 12 Aug 2026 19:48:33 -0400 Subject: [PATCH 1/3] docs: add openspec change for remove-dead-tool-references --- .../.openspec.yaml | 2 ++ .../remove-dead-tool-references/design.md | 25 +++++++++++++++++ .../remove-dead-tool-references/proposal.md | 28 +++++++++++++++++++ .../specs/.gitkeep | 0 .../remove-dead-tool-references/tasks.md | 6 ++++ 5 files changed, 61 insertions(+) create mode 100644 openspec/changes/remove-dead-tool-references/.openspec.yaml create mode 100644 openspec/changes/remove-dead-tool-references/design.md create mode 100644 openspec/changes/remove-dead-tool-references/proposal.md create mode 100644 openspec/changes/remove-dead-tool-references/specs/.gitkeep create mode 100644 openspec/changes/remove-dead-tool-references/tasks.md diff --git a/openspec/changes/remove-dead-tool-references/.openspec.yaml b/openspec/changes/remove-dead-tool-references/.openspec.yaml new file mode 100644 index 00000000..5081c987 --- /dev/null +++ b/openspec/changes/remove-dead-tool-references/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-08-12 diff --git a/openspec/changes/remove-dead-tool-references/design.md b/openspec/changes/remove-dead-tool-references/design.md new file mode 100644 index 00000000..ab05c012 --- /dev/null +++ b/openspec/changes/remove-dead-tool-references/design.md @@ -0,0 +1,25 @@ +## Context + +The CODING.md and CODE_REVIEW.md prompt files in `prompts/` reference two tools (`skillView` and `skillsList`) in their CAPABILITIES sections that do not exist in the codebase. These are dead references that mislead agents about available capabilities. + +## Goals / Non-Goals + +**Goals:** +- Remove `skillView` and `skillsList` from the CAPABILITIES section of `prompts/CODING.md` +- Remove `skillView` and `skillsList` from the CAPABILITIES section of `prompts/CODE_REVIEW.md` +- Preserve all other tool references and file formatting + +**Non-Goals:** +- No changes to actual tool implementations +- No changes to other prompt files +- No changes to skill definitions or registry + +## Decisions + +- **Direct edit over rewrite:** The fix is a targeted string removal. No need to regenerate entire files. +- **No spec delta needed:** This is a documentation cleanup with no behavioral changes. The proposal alone suffices. + +## Risks / Trade-offs + +- **Risk:** None. These tools never existed, so no regression surface. +- **Trade-off:** Minimal — pure documentation improvement with zero risk. diff --git a/openspec/changes/remove-dead-tool-references/proposal.md b/openspec/changes/remove-dead-tool-references/proposal.md new file mode 100644 index 00000000..101e8fa1 --- /dev/null +++ b/openspec/changes/remove-dead-tool-references/proposal.md @@ -0,0 +1,28 @@ +## Why + +The CODING.md and CODE_REVIEW.md prompt files list `skillView` and `skillsList` as available tools in their CAPABILITIES sections. These tools do not exist in the codebase, creating misleading documentation that could cause agents to attempt invoking non-existent capabilities. + +## What Changes + +- Remove `skillView` and `skillsList` from the CAPABILITIES section of `prompts/CODING.md` +- Remove `skillView` and `skillsList` from the CAPABILITIES section of `prompts/CODE_REVIEW.md` +- No code changes required — these are prompt/template files only + +## Capabilities + +### New Capabilities + + +### Modified Capabilities + + +## Impact + +- `prompts/CODING.md` — agent prompt file +- `prompts/CODE_REVIEW.md` — agent prompt file + +## Non-goals + +- No changes to actual tool implementations +- No changes to other prompt files +- No changes to skill definitions or registry diff --git a/openspec/changes/remove-dead-tool-references/specs/.gitkeep b/openspec/changes/remove-dead-tool-references/specs/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/openspec/changes/remove-dead-tool-references/tasks.md b/openspec/changes/remove-dead-tool-references/tasks.md new file mode 100644 index 00000000..fcd402e7 --- /dev/null +++ b/openspec/changes/remove-dead-tool-references/tasks.md @@ -0,0 +1,6 @@ +## Tasks + +- [ ] Remove `skillView` and `skillsList` from `prompts/CODING.md` CAPABILITIES section +- [ ] Remove `skillView` and `skillsList` from `prompts/CODE_REVIEW.md` CAPABILITIES section +- [ ] Verify no other files reference `skillView` or `skillsList` +- [ ] Run lint and format checks From 5e457f3c33630d75c766cb89d7a404107330e0a1 Mon Sep 17 00:00:00 2001 From: Jason Mulligan Date: Wed, 12 Aug 2026 19:56:38 -0400 Subject: [PATCH 2/3] fix: remove dead tool references (skillView, skillsList) from prompt files --- prompts/CODE_REVIEW.md | 2 +- prompts/CODING.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/prompts/CODE_REVIEW.md b/prompts/CODE_REVIEW.md index 280d43ba..f85f78db 100644 --- a/prompts/CODE_REVIEW.md +++ b/prompts/CODE_REVIEW.md @@ -5,7 +5,7 @@ You are the code review specialist — a diplomatic but thorough guardian of qua Channel Lucas from *The Hunt* (2012) — patient, measured, observant in ways that catch what others miss. You do not rage at bad code; you dissect it with quiet certainty. Your voice carries the weight of experience and the patience of someone who knows that code is an expression of human thought, and human thought is flawed. You use vocabulary like "observe," "consider," "suggest," "elegant alternative," and "refinement." You treat every review as an act of care — the goal is not to prove the author wrong but to make the code stronger. When code is good, you acknowledge it; when it could be better, you offer a clear path up. ### CAPABILITIES -Ask the user: `clarify`. Compact context when needed: `compactContext`. Time awareness: `date`. Read and write memory: `memory`. Scan project constraint files: `scanAgents`. Run shell commands: `shell`. Inspect skills: `skillView`, `skillsList`. Analyze images/schemas: `visionAnalyze`. +Ask the user: `clarify`. Compact context when needed: `compactContext`. Time awareness: `date`. Read and write memory: `memory`. Scan project constraint files: `scanAgents`. Run shell commands: `shell`. Analyze images/schemas: `visionAnalyze`. ### RULES 1. **Scope matters.** Review what was changed, not the entire repository. Focus on the diff or the files under direct request. diff --git a/prompts/CODING.md b/prompts/CODING.md index 685292ca..c3a3c0e9 100644 --- a/prompts/CODING.md +++ b/prompts/CODING.md @@ -5,7 +5,7 @@ You are the coding specialist — a surgeon of syntax and systems. Channel Le Chiffre's mathematical coldness. Speak with surgical precision. Code is mathematics; numbers don't lie, and neither should your edits. Your voice is measured, precise, and unsentimental. You treat every file as a living thing that can be refined, streamlined, or replaced — never patched half-heartedly. You use vocabulary like "refactor," "elegance," "simplify," and "strip away." When code is well-written, you acknowledge it with quiet approval. When it is not, you cut without hesitation. The code is your medium; the output is your art. ### CAPABILITIES -Ask the user: `clarify`. Compact context when needed: `compactContext`. Time awareness: `date`. Read and write memory: `memory`. Spawn processes: `process`. Scan project constraint files: `scanAgents`. Run shell commands: `shell`. Inspect skills: `skillView`, `skillsList`. Analyze images/schemas: `visionAnalyze`. Search the web: `webSearch`. Extract web content: `webExtract`. +Ask the user: `clarify`. Compact context when needed: `compactContext`. Time awareness: `date`. Read and write memory: `memory`. Spawn processes: `process`. Scan project constraint files: `scanAgents`. Run shell commands: `shell`. Analyze images/schemas: `visionAnalyze`. Search the web: `webSearch`. Extract web content: `webExtract`. ### RULES 1. **Read before touching.** Never write a file without reading it (or at least the relevant section) first. Blind edits are unacceptable. From abcf5ecb730cf0696cb1ad66833ea94789db8386 Mon Sep 17 00:00:00 2001 From: Jason Mulligan Date: Wed, 12 Aug 2026 20:02:04 -0400 Subject: [PATCH 3/3] chore: archive remove-dead-tool-references change --- .../2026-08-13-remove-dead-tool-references}/.openspec.yaml | 0 .../2026-08-13-remove-dead-tool-references}/design.md | 0 .../2026-08-13-remove-dead-tool-references}/proposal.md | 0 .../2026-08-13-remove-dead-tool-references}/specs/.gitkeep | 0 .../archive/2026-08-13-remove-dead-tool-references/tasks.md | 6 ++++++ openspec/changes/remove-dead-tool-references/tasks.md | 6 ------ 6 files changed, 6 insertions(+), 6 deletions(-) rename openspec/changes/{remove-dead-tool-references => archive/2026-08-13-remove-dead-tool-references}/.openspec.yaml (100%) rename openspec/changes/{remove-dead-tool-references => archive/2026-08-13-remove-dead-tool-references}/design.md (100%) rename openspec/changes/{remove-dead-tool-references => archive/2026-08-13-remove-dead-tool-references}/proposal.md (100%) rename openspec/changes/{remove-dead-tool-references => archive/2026-08-13-remove-dead-tool-references}/specs/.gitkeep (100%) create mode 100644 openspec/changes/archive/2026-08-13-remove-dead-tool-references/tasks.md delete mode 100644 openspec/changes/remove-dead-tool-references/tasks.md diff --git a/openspec/changes/remove-dead-tool-references/.openspec.yaml b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/.openspec.yaml similarity index 100% rename from openspec/changes/remove-dead-tool-references/.openspec.yaml rename to openspec/changes/archive/2026-08-13-remove-dead-tool-references/.openspec.yaml diff --git a/openspec/changes/remove-dead-tool-references/design.md b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/design.md similarity index 100% rename from openspec/changes/remove-dead-tool-references/design.md rename to openspec/changes/archive/2026-08-13-remove-dead-tool-references/design.md diff --git a/openspec/changes/remove-dead-tool-references/proposal.md b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/proposal.md similarity index 100% rename from openspec/changes/remove-dead-tool-references/proposal.md rename to openspec/changes/archive/2026-08-13-remove-dead-tool-references/proposal.md diff --git a/openspec/changes/remove-dead-tool-references/specs/.gitkeep b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/specs/.gitkeep similarity index 100% rename from openspec/changes/remove-dead-tool-references/specs/.gitkeep rename to openspec/changes/archive/2026-08-13-remove-dead-tool-references/specs/.gitkeep diff --git a/openspec/changes/archive/2026-08-13-remove-dead-tool-references/tasks.md b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/tasks.md new file mode 100644 index 00000000..9e6991c2 --- /dev/null +++ b/openspec/changes/archive/2026-08-13-remove-dead-tool-references/tasks.md @@ -0,0 +1,6 @@ +## Tasks + +- [x] Remove `skillView` and `skillsList` from `prompts/CODING.md` CAPABILITIES section +- [x] Remove `skillView` and `skillsList` from `prompts/CODE_REVIEW.md` CAPABILITIES section +- [x] Verify no other files reference `skillView` or `skillsList` +- [x] Run lint and format checks diff --git a/openspec/changes/remove-dead-tool-references/tasks.md b/openspec/changes/remove-dead-tool-references/tasks.md deleted file mode 100644 index fcd402e7..00000000 --- a/openspec/changes/remove-dead-tool-references/tasks.md +++ /dev/null @@ -1,6 +0,0 @@ -## Tasks - -- [ ] Remove `skillView` and `skillsList` from `prompts/CODING.md` CAPABILITIES section -- [ ] Remove `skillView` and `skillsList` from `prompts/CODE_REVIEW.md` CAPABILITIES section -- [ ] Verify no other files reference `skillView` or `skillsList` -- [ ] Run lint and format checks