Skip to content

feat(procedures): optimize knowledge/ procedures for token efficiency#1109

Open
atxtechbro wants to merge 1 commit intomainfrom
feature/optimize-knowledge-1098
Open

feat(procedures): optimize knowledge/ procedures for token efficiency#1109
atxtechbro wants to merge 1 commit intomainfrom
feature/optimize-knowledge-1098

Conversation

@atxtechbro
Copy link
Owner

Git Statistics

7 files changed, 368 insertions(+), 513 deletions(-)

🎯 Overview

This PR transforms our knowledge/ procedures from verbose documentation to concise pointers, dramatically reducing token usage in every Claude Code session while maintaining all detailed information in appropriate locations.

📊 Token Reduction Impact

File Before After Reduction
issue-to-pr-workflow.md 105 lines 6 lines 94%
procedure-creation.md 96 lines 6 lines 94%
close-issue-procedure.md 93 lines 6 lines 94%
git-workflow.md 59 lines 10 lines 83%
worktree-workflow.md 36 lines 7 lines 81%
TOTAL 389 lines 35 lines 91%

🚀 Key Changes

Concise Knowledge Format

Each procedure now follows the pattern:

  • Brief description (1 line)
  • When to use (1 line)
  • Link to details (1 line)

Detailed Documentation Moved

  • .github/ISSUE_TEMPLATE/close-issue-guide.md - Full close issue workflow
  • docs/procedures/ - All detailed procedures with examples and templates

Preserved All Content

No information was lost - just relocated to more appropriate locations that don't consume tokens on every session.

✅ Benefits

  • 91% token reduction in knowledge/ procedures
  • Faster Claude Code startup with less preloaded content
  • Better focus on current task without noise
  • Follows subtraction-creates-value principle

📁 Files Changed

Optimized Procedures (knowledge/)

  • ✂️ close-issue-procedure.md
  • ✂️ git-workflow.md
  • ✂️ issue-to-pr-workflow.md
  • ✂️ procedure-creation.md
  • ✂️ worktree-workflow.md

New Detailed Guides (docs/ & .github/)

  • 📄 .github/ISSUE_TEMPLATE/close-issue-guide.md
  • 📄 docs/procedures/git-workflow-detailed.md
  • 📄 docs/procedures/issue-to-pr-detailed-workflow.md
  • 📄 docs/procedures/procedure-creation-guide.md
  • 📄 docs/procedures/worktree-troubleshooting.md

🎭 Principles Applied

  • subtraction-creates-value: Removed redundancy, kept essence
  • selective-optimization: 80/20 rule - procedures available when needed
  • systems-stewardship: Maintained single source of truth

Closes #1098

Move detailed content from knowledge/ to docs/ and .github/ISSUE_TEMPLATE/
to reduce token usage in every Claude Code session. Knowledge procedures
now follow concise pattern: philosophy, when to use, link to details.

Optimized files:
- issue-to-pr-workflow.md (105→6 lines)
- procedure-creation.md (96→6 lines)
- close-issue-procedure.md (93→6 lines)
- git-workflow.md (59→10 lines)
- worktree-workflow.md (36→7 lines)

Closes #1098

Principle: subtraction-creates-value
@amazon-q-developer
Copy link
Contributor

⏳ I'm reviewing this pull request for security vulnerabilities and code quality issues. I'll provide an update when I'm done

@amazon-q-developer
Copy link
Contributor

✅ I finished the code review, and didn't find any security or code quality issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Procedures] Optimize knowledge/ procedures for token efficiency

1 participant