Skip to content

Commit 3b1c4b6

Browse files
authored
cleanup: remove prompt orchestrator documentation and vestigial syntax (#1377)
Remove all documentation, procedures, and vestigial syntax for the prompt orchestrator system deleted in PR #1355 (Oct 9, 2025). The entire template generation architecture was replaced by Claude Code's native plugin system. ## Files Removed **Documentation (obsolete):** - `docs/prompt-orchestration.md` - Described template syntax for deleted orchestrator - `docs/prompt-orchestrator-security.md` - Security docs for deleted code **Procedure (obsolete):** - `knowledge/procedures/command-lifecycle-management.md` - Referenced deleted tools: - utils/sync-claude-commands.sh (removed PR #1355) - utils/generate-commands.sh (removed PR #1355) - .claude/command-templates/ (never existed) **Artifacts (untracked):** - `utils/__pycache__/prompt_orchestrator.cpython-312.pyc` - Not in git, removed manually ## Vestigial Syntax Removed **commands/close-issue.md** - Removed 2 non-functional markers: - Line 52: `{{ INJECT:principles/tracer-bullets.md }}` - Line 69: `{{ INJECT:principles/eager-evolution.md }}` **commands/extract-best-frame.md** - Removed 1 non-functional marker: - Line 211: `{{ INJECT:principles/tracer-bullets.md }}` These `{{ INJECT: }}` markers were remnants of the deleted orchestrator's template processing. They're not processed by any current system - GitHub Actions only processes `{{ KNOWLEDGE_BASE }}` and local commands don't process them at all. The principles are already available in context, making these markers vestigial documentation cruft. ## Updated **knowledge/principles/systems-stewardship.md:26** - Updated gitignore example: - Old: Referenced deleted `.claude/command-templates` - New: References current `mlruns/` (MLflow tracking data) ## Context The prompt orchestrator (utils/prompt_orchestrator.py) was removed in commit 688fe9d along with 1,131 lines of template generation tooling. These docs and syntax markers were orphaned but not removed at the time. ## Impact - 3 docs files removed (~150 lines) - 1 procedure removed (42 lines) - 3 vestigial syntax markers removed - 1 principle example updated - Zero functional loss - all referenced deleted systems or non-functional syntax Related to #1355 (orchestrator removal) Related to #1352 (plugin system replacement) Principle: subtraction-creates-value
1 parent ce24fcd commit 3b1c4b6

6 files changed

Lines changed: 1 addition & 156 deletions

File tree

commands/close-issue.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,6 @@ Complete and implement GitHub issue #{{ ISSUE_NUMBER }}.
4949
<!-- Contract: Issue context loaded, working in worktree -->
5050
Build the solution using tracer bullets - get something working first, then iterate.
5151

52-
{{ INJECT:principles/tracer-bullets.md }}
53-
5452
## Creating the Pull Request
5553

5654
**IMPORTANT**: This procedure outputs a GitHub Pull Request. The PR must be created, not just planned.
@@ -66,8 +64,6 @@ See `.github/PULL_REQUEST_TEMPLATE.md` for complete guidance on title patterns a
6664
## Final Step: Retro
6765
Let's retro this context and wring out the gleanings.
6866

69-
{{ INJECT:principles/eager-evolution.md }}
70-
7167
**Consider capturing any ghost procedures** that emerged during this work - see [Procedure Creation](knowledge/procedures/procedure-creation.md).
7268

7369
**What would you like to focus on?**

commands/extract-best-frame.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -208,8 +208,6 @@ Display summary of all processed videos:
208208
!done
209209
!echo ""
210210

211-
{{ INJECT:principles/tracer-bullets.md }}
212-
213211
## Next Steps
214212

215213
The best frame extraction is complete!

docs/prompt-orchestration.md

Lines changed: 0 additions & 42 deletions
This file was deleted.

docs/prompt-orchestrator-security.md

Lines changed: 0 additions & 65 deletions
This file was deleted.

knowledge/principles/systems-stewardship.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The principle of maintaining and improving systems through consistent patterns,
2323
- "Vísteme despacio, que tengo prisa" - move deliberately, not frantically
2424
- **Never let a crisis go to waste**: Each failure becomes input for stronger procedures and prevention systems
2525
- **Leave cookie crumbs**: Document architectural decisions inline where future engineers encounter them. Git commit messages fade into history; inline comments create discoverable breadcrumbs for faster resolution.
26-
- **Gitignore as architectural documentation**: Every gitignore entry embeds meaning about system structure. `# Setup-generated symlinks (avoid duplicating tracked content)` tells the story of why `.claude/command-templates` exists. Each line is a clue to underlying architecture, not just file exclusion.
26+
- **Gitignore as architectural documentation**: Every gitignore entry embeds meaning about system structure. `# MLflow experiment tracking data (regenerated on each run)` tells the story of why `mlruns/` is excluded. Each line is a clue to underlying architecture, not just file exclusion.
2727

2828
**GitHub Issues as WIP Inventory:**
2929
- Backlog buildup indicates bottlenecks in the development flow

knowledge/procedures/command-lifecycle-management.md

Lines changed: 0 additions & 42 deletions
This file was deleted.

0 commit comments

Comments
 (0)