You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Elevate companion tools visibility, remove GitNexus block from CLAUDE.md
Companion tools (Gemini Search, GitNexus) were buried at the bottom of
multi-tool-setup.md where users would never find them. Now surfaced in
three places: getting-started Step 5, multi-tool-setup TL;DR, and the
GETTING_STARTED.md generated by ctx init.
Removed the 121-line GitNexus block from CLAUDE.md (61% of the file) —
it was low-value per-turn budget consumption. The same instructions
already live in .claude/skills/gitnexus/ where they activate on demand.
Deleted AGENTS.md (Codex convention, duplicate content).
Also: archive 25 completed PD tasks, gitignore .gitnexus and generated
skills, blog frontmatter finalization, docs/index.md wording fix,
regenerate site.
Signed-off-by: Jose Alekhinne <jose@ctx.ist>
Copy file name to clipboardExpand all lines: .context/DECISIONS.md
+30Lines changed: 30 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,8 @@
3
3
<!-- INDEX:START -->
4
4
| Date | Decision |
5
5
|------|--------|
6
+
| 2026-03-25 | Companion tools documented as optional MCP enhancements with runtime check |
7
+
| 2026-03-25 | Prompt templates removed — skills are the single agent instruction mechanism |
6
8
| 2026-03-24 | Write-once baseline with explicit end-consolidation for consolidation lifecycle |
7
9
| 2026-03-23 | Pre/pre HTML tags promoted to shared constants in config/marker |
8
10
| 2026-03-23 | Pure-data param structs in entity — replace function pointers with text keys |
@@ -109,6 +111,34 @@ For significant decisions:
109
111
110
112
-->
111
113
114
+
## [2026-03-25-173337] Companion tools documented as optional MCP enhancements with runtime check
115
+
116
+
**Status**: Accepted
117
+
118
+
**Context**: Gemini Search and GitNexus improve skills but no docs mentioned them and no code checked their availability
119
+
120
+
**Decision**: Companion tools documented as optional MCP enhancements with runtime check
121
+
122
+
**Rationale**: Users should know what tools enhance their workflow without being forced to install them. Suppressible via .ctxrc for users who don't want them.
123
+
124
+
**Consequence**: /ctx-remember smoke-tests MCPs at session start. companion_check: false suppresses.
125
+
126
+
---
127
+
128
+
## [2026-03-25-173336] Prompt templates removed — skills are the single agent instruction mechanism
129
+
130
+
**Status**: Accepted
131
+
132
+
**Context**: Prompt templates (.context/prompts/) overlapped with skills but had no discoverability — even the project creator didn't know they existed
133
+
134
+
**Decision**: Prompt templates removed — skills are the single agent instruction mechanism
135
+
136
+
**Rationale**: Adding metadata to prompts to fix discoverability would recreate the skill system. One concept is better than two.
137
+
138
+
**Consequence**: code-review, explain, refactor promoted to proper skills. ctx prompt CLI removed. loop.md retained as ctx loop config file at .context/loop.md.
139
+
140
+
---
141
+
112
142
## [2026-03-24-001001] Write-once baseline with explicit end-consolidation for consolidation lifecycle
## [2026-03-25-173339] Dead files accumulate when nothing consumes them
115
+
116
+
**Context**: IMPLEMENTATION_PLAN.md and PROMPT.md were created by ctx init but no agent, hook, or skill ever read them
117
+
118
+
**Lesson**: Before adding a file to init scaffolding, verify there is at least one consumer. Periodically audit what init creates vs what the system reads.
119
+
120
+
**Application**: The prompt deprecation spec documents the reasoning as a papertrail for future removals.
121
+
122
+
---
123
+
124
+
## [2026-03-25-173338] Template improvements don't propagate to existing projects
125
+
126
+
**Context**: 5 of 8 context files in the ctx project itself had stale/missing comment headers — templates evolved but non-destructive init never re-synced them
127
+
128
+
**Lesson**: Any template change is invisible to existing users until they run ctx init --force
129
+
130
+
**Application**: Added drift detection (checkTemplateHeaders) to ctx drift. Consider surfacing this during ctx status too.
131
+
132
+
---
133
+
112
134
## [2026-03-24-001001] lint-drift false positives from conflating constant namespaces
113
135
114
136
**Context**: lint-drift.sh checked all string constants in embed/cmd/*.go against commands.yaml, but Use* constants are cobra syntax strings, not YAML lookup keys
-[x] PD.3.8: Remove `prompt-templates/*.md` from embed.go glob #priority:high #added:2026-03-25-203340 #done:2026-03-25
58
-
-[x] PD.3.9: Remove `Prompts` constant from `internal/config/dir/dir.go` #priority:high #added:2026-03-25-203340 #done:2026-03-25
59
-
-[x] PD.3.10: Remove `DirPromptTemplates` from `internal/config/asset/asset.go` #priority:high #added:2026-03-25-203340 #done:2026-03-25
60
-
-[x] PD.3.11: Remove prompt-specific error keys/functions from `internal/config/embed/text/err_prompt.go` and `internal/err/prompt/` (keep if used elsewhere) #priority:high #added:2026-03-25-203340 #done:2026-03-25
-[x] PD.4.6: Search and update any remaining doc references to `.context/prompts/` or `ctx prompt` #priority:medium #added:2026-03-25-203340 #done:2026-03-25
72
48
73
49
**PD.5 — Validate:**
74
50
75
-
-[x] PD.5.1: Run `make lint && make test` — all tests pass, no dangling imports #priority:high #added:2026-03-25-203340 #done:2026-03-25
76
51
-[ ] PD.5.2: Run `ctx init` on a clean directory — verify no `.context/prompts/` created, `.context/loop.md` exists, new skills deployed #priority:high #added:2026-03-25-203340
77
52
78
53
### Phase -3: DevEx
@@ -84,18 +59,36 @@ projects.
84
59
85
60
-[ ] Add cobra Example fields to CLI commands via examples.yaml #added:2026-03-20-163413
86
61
87
-
-[ ] Evaluate Gemini Search MCP server as peer MCP for grounded web queries — try gemini-grounding, document in multi-tool-setup recipe if useful. See ideas/gemini-search-mcp.md #added:2026-03-20-141022
62
+
-[ ] Evaluate Gemini Search MCP server as peer MCP for grounded web queries —
63
+
try gemini-grounding, document in multi-tool-setup recipe if useful.
64
+
See ideas/gemini-search-mcp.md #added:2026-03-20-141022
88
65
89
-
-[ ] Create ctx-docstrings skill: audit and fix docstrings against CONVENTIONS.md Documentation section. Skill loads CONVENTIONS.md, scans functions in scope for missing/incomplete docstring sections (Parameters, Returns), reports violations, and optionally fixes them. Language-agnostic design with Go as first implementation. Deterministic enforcement via linter is tracked separately in ideas/spec-convention-enforcement.md #added:2026-03-16-114445
66
+
-[ ] Create ctx-docstrings skill: audit and fix docstrings against
-[ ] Design UserPromptSubmit hook that runs `make audit` at session start and
94
-
surfaces failures as a consolidation-debt warning before the agent acts on stale assumptions. Project-level hook (not bundled in ctx), configurable via .ctxrc or settings.json. Related: consolidation nudge hook spec. #added:2026-03-23-223500
95
-
96
-
-[ ] Bug: check-version hook missing throttle touch on plugin version read error (run.go:70). When claude.PluginVersion() fails, the hook returns without touching the daily throttle marker, causing repeated checks on days when plugin.json is missing or corrupted. Fix: add internalIo.TouchFile(markerFile) before the early return. See docs/recipes/hook-sequence-diagrams.md check-version diagram which documents the expected behavior. #added:2026-03-23-162802
97
-
98
-
-[ ] Design UserPromptSubmit hook that runs go build and surfaces compilation errors before the agent acts on stale assumptions #added:2026-03-23-120136
77
+
surfaces failures as a consolidation-debt warning before the agent acts on
78
+
stale assumptions. Project-level hook (not bundled in ctx), configurable
0 commit comments