Skip to content

docs: add Claude Code token efficiency playbook#1

Merged
Arry8 merged 8 commits intomainfrom
feature/token-efficiency-playbook
Mar 13, 2026
Merged

docs: add Claude Code token efficiency playbook#1
Arry8 merged 8 commits intomainfrom
feature/token-efficiency-playbook

Conversation

@Arry8
Copy link
Copy Markdown
Owner

@Arry8 Arry8 commented Mar 13, 2026

Summary

  • Add 14-section token efficiency playbook (docs/claude-workflow.md) adapted to TypeScript/pnpm/Vitest/OpenClaw stack, structured with <context>/<rules> XML tags following Anthropic's long-context prompt engineering patterns
  • Add curated repo file index (docs/repo-map.json) mapping core src/ modules to purpose, exports, and dependencies — enables file discovery without directory scanning
  • Add high-level architecture overview (docs/architecture_summary.md) covering modules, channel architecture, skill system, build pipeline, and data flows
  • Add 5 reusable prompt templates (prompts/) for implement-issue, debug-issue, write-test, refactor, and review-diff workflows
  • Add autonomous agent loop script (scripts/run-issue.sh) — issue to PR pipeline using Haiku for decomposition and Sonnet for implementation
  • Add playbook/repo-map references to AGENTS.md + coding style additions (descriptive identifiers, comment guidelines, boundary-only error handling)

Test plan

  • CLAUDE.md symlink resolves to AGENTS.md
  • docs/repo-map.json is valid JSON
  • docs/claude-workflow.md contains zero .NET/C# references
  • All 5 prompt templates reference TS file paths and Vitest conventions
  • scripts/run-issue.sh uses pnpm build/pnpm test
  • chmod +x scripts/run-issue.sh (needs manual run)

steipete and others added 8 commits March 13, 2026 12:59
…5088)

Merged via squash.

Prepared head SHA: 99eb3fd
Co-authored-by: velvet-shark <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Reviewed-by: @velvet-shark
Auto-updates docs/repo-map.json exports and dependencies when
src/ or extensions/ .ts files are committed. Preserves existing
purpose fields, removes deleted files, adds new files with empty
purpose. Regex-based extraction, no dependencies.
@Arry8 Arry8 merged commit d3f411a into main Mar 13, 2026
@Arry8 Arry8 deleted the feature/token-efficiency-playbook branch March 13, 2026 14:55
Arry8 added a commit that referenced this pull request Mar 15, 2026
* fix(node-host): harden pnpm approval binding

* fix(node-host): harden perl approval binding

* docs(plugins): clarify workspace shadowing

* fix(ui): keep shared auth on insecure control-ui connects (openclaw#45088)

Merged via squash.

Prepared head SHA: 99eb3fd
Co-authored-by: velvet-shark <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Reviewed-by: @velvet-shark

* docs: add Claude Code token efficiency playbook

* docs: compress playbook for agent consumption

* docs: restructure playbook for long-context patterns

* pre-commit: add incremental repo-map updater

Auto-updates docs/repo-map.json exports and dependencies when
src/ or extensions/ .ts files are committed. Preserves existing
purpose fields, removes deleted files, adds new files with empty
purpose. Regex-based extraction, no dependencies.

---------

Co-authored-by: Peter Steinberger <[email protected]>
Co-authored-by: Radek Sienkiewicz <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Arry8 added a commit that referenced this pull request Mar 16, 2026
* fix(node-host): harden pnpm approval binding

* fix(node-host): harden perl approval binding

* docs(plugins): clarify workspace shadowing

* fix(ui): keep shared auth on insecure control-ui connects (openclaw#45088)

Merged via squash.

Prepared head SHA: 99eb3fd
Co-authored-by: velvet-shark <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Reviewed-by: @velvet-shark

* docs: add Claude Code token efficiency playbook

* docs: compress playbook for agent consumption

* docs: restructure playbook for long-context patterns

* pre-commit: add incremental repo-map updater

Auto-updates docs/repo-map.json exports and dependencies when
src/ or extensions/ .ts files are committed. Preserves existing
purpose fields, removes deleted files, adds new files with empty
purpose. Regex-based extraction, no dependencies.

---------

Co-authored-by: Peter Steinberger <[email protected]>
Co-authored-by: Radek Sienkiewicz <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Arry8 added a commit that referenced this pull request Mar 23, 2026
* fix(node-host): harden pnpm approval binding

* fix(node-host): harden perl approval binding

* docs(plugins): clarify workspace shadowing

* fix(ui): keep shared auth on insecure control-ui connects (openclaw#45088)

Merged via squash.

Prepared head SHA: 99eb3fd
Co-authored-by: velvet-shark <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Reviewed-by: @velvet-shark

* docs: add Claude Code token efficiency playbook

* docs: compress playbook for agent consumption

* docs: restructure playbook for long-context patterns

* pre-commit: add incremental repo-map updater

Auto-updates docs/repo-map.json exports and dependencies when
src/ or extensions/ .ts files are committed. Preserves existing
purpose fields, removes deleted files, adds new files with empty
purpose. Regex-based extraction, no dependencies.

---------

Co-authored-by: Peter Steinberger <[email protected]>
Co-authored-by: Radek Sienkiewicz <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Arry8 added a commit that referenced this pull request Mar 29, 2026
* fix(node-host): harden pnpm approval binding

* fix(node-host): harden perl approval binding

* docs(plugins): clarify workspace shadowing

* fix(ui): keep shared auth on insecure control-ui connects (openclaw#45088)

Merged via squash.

Prepared head SHA: 99eb3fd
Co-authored-by: velvet-shark <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
Reviewed-by: @velvet-shark

* docs: add Claude Code token efficiency playbook

* docs: compress playbook for agent consumption

* docs: restructure playbook for long-context patterns

* pre-commit: add incremental repo-map updater

Auto-updates docs/repo-map.json exports and dependencies when
src/ or extensions/ .ts files are committed. Preserves existing
purpose fields, removes deleted files, adds new files with empty
purpose. Regex-based extraction, no dependencies.

---------

Co-authored-by: Peter Steinberger <[email protected]>
Co-authored-by: Radek Sienkiewicz <[email protected]>
Co-authored-by: velvet-shark <[email protected]>
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.

3 participants