Skip to content

Optimize setup context budget: tiered skills, deferred reads, pruned … - #13

Open
friedrch wants to merge 2 commits into
mainfrom
refactor/setup
Open

Optimize setup context budget: tiered skills, deferred reads, pruned …#13
friedrch wants to merge 2 commits into
mainfrom
refactor/setup

Conversation

@friedrch

Copy link
Copy Markdown
Contributor

…re-reads

Three changes to reduce setup's context consumption by ~2,400 lines:

  1. Tiered skill generation (Step 9): Classify 16 skills into three tiers — A (copy: learn, tasks), B (frontmatter-only: reflect, reweave, stats, graph, refactor), C (DOMAIN substitution: seed, pipeline, ralph, rethink, next, validate, remember, reduce, verify). Tiers A+B skip body reasoning entirely; Tier C does mechanical string replacement only. Corrects plan misclassification of reduce and verify (both have {DOMAIN:xxx} patterns, moved from B to C).

  2. Defer upfront reference reads: Trim mandatory reads from 8 files (~2,268 lines) to 3 (kernel.yaml, interaction-constraints.md, vocabulary-transforms.md). Defer use-case-presets to Step 3c (matched preset only), personality-layer to Step 3d (only if signals detected). Inline failure-modes vulnerability matrix into Step 3f. Drop three-spaces.md (covered by Step 2) and conversation-patterns.md (consult on ambiguity only).

  3. Eliminate redundant re-reads: Remove 6 of 14 ops/derivation.md re-reads (Steps 4, 5, 5f, 5g, 6, 11 — small files from info already in context) and 2 interaction-constraints.md re-reads (Steps 3b, 3e — already loaded upfront).

friedrch and others added 2 commits February 19, 2026 20:47
…re-reads

Three changes to reduce setup's context consumption by ~2,400 lines:

1. Tiered skill generation (Step 9): Classify 16 skills into three
   tiers — A (copy: learn, tasks), B (frontmatter-only: reflect,
   reweave, stats, graph, refactor), C (DOMAIN substitution: seed,
   pipeline, ralph, rethink, next, validate, remember, reduce, verify).
   Tiers A+B skip body reasoning entirely; Tier C does mechanical
   string replacement only. Corrects plan misclassification of reduce
   and verify (both have {DOMAIN:xxx} patterns, moved from B to C).

2. Defer upfront reference reads: Trim mandatory reads from 8 files
   (~2,268 lines) to 3 (kernel.yaml, interaction-constraints.md,
   vocabulary-transforms.md). Defer use-case-presets to Step 3c
   (matched preset only), personality-layer to Step 3d (only if
   signals detected). Inline failure-modes vulnerability matrix into
   Step 3f. Drop three-spaces.md (covered by Step 2) and
   conversation-patterns.md (consult on ambiguity only).

3. Eliminate redundant re-reads: Remove 6 of 14 ops/derivation.md
   re-reads (Steps 4, 5, 5f, 5g, 6, 11 — small files from info
   already in context) and 2 interaction-constraints.md re-reads
   (Steps 3b, 3e — already loaded upfront).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…4 and 5g

- failure-modes.md: "not needed" annotation contradicted line 446 which
  still said "consult." Changed to scoped deferred read (HIGH-risk sections
  only) with explicit instruction to use prevention patterns for Common Pitfalls.
- Step 4 (identity.md): restored re-read of derivation.md + conditional
  personality-layer.md re-read. Step 3 is the largest generation task;
  without the re-read anchor, personality dimensions drift out of attention.
- Step 5g (manual/): restored re-read of derivation.md before 7 manual
  pages. Prevents vocabulary drift across a long multi-file generation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
NevoleMarek added a commit to datamole-ai/arscontexta that referenced this pull request Apr 7, 2026
crichalchemist referenced this pull request in crichalchemist/arscontexta Aug 15, 2026
…-35 provenance

Records-only, no behavior change.

- deferrals.md #13: amended in place (not reopened, not closed). Task 10's
  else-warning on the NOTES_DIR guard does not trip #13's stated "Reopens if"
  trigger, but does narrow its "rare failure" framing -- the outer guard means
  the block #13 diagnoses never runs at all for any vault whose notes
  directory isn't literally notes/, the default case for a customized
  {{NOTES_DIR}}, not a rare one. Also corrects #13's own drifted line
  citations (:165/:162 -> :177/:163).

- CLAUDE.md: documents QUEUE_EDIT_VERSION (bumped 1->2 by task 12a), the
  third library version this file tracks alongside LINK_EXTRACTION_VERSION
  and FRONTMATTER_VERSION, with re-derivation commands. The three
  already-correct numerals (17 gates, 30 CI steps this branch, 28 on main)
  are untouched -- re-verified, not changed.

- deferrals.md agenticnotetaking#26 (new): PR #7 merged 46 commits; the link-edge-map plan
  that drove its review describes only 35. Eleven earlier backport commits,
  including the entire initial reference/lib/queue-edit.sh, rode along
  undescribed and never passed through the plan's review. Findings F1
  (queue_edit's unguarded commit-step mv) and F6 (/health omitting
  queue-edit.sh) both live in that undescribed half -- both already fixed by
  task 12a. Cross-references the design spec's "Provenance matters here"
  paragraph so the process lesson survives past this branch's own
  task-scoped documents.

- plan's Deferrals section: records that Task 15 itself deferred nothing of
  its own -- entry 26 and the deferral-13 amendment are its Step 1/Step 3
  deliverables, not scoped-out work.

Verified: check-doc-claims.sh green (foreground, before this commit, per
Step 4 -- it reads a git range and rots on merge with no diff to notice).
Full sweep green in both shells: check-portability, check-prose-paths,
check-placeholder-count, check-vocabulary-schema, check-doc-claims.test.sh
(13/13), and all ten dual-shell suites (link-extraction 101/101,
guard-failure 66/66, fence-isolation PASS, bump-version 41/41,
kernel-note-dirs 76/76, threshold-namespace 56/56, placeholder-count 40/40,
hook-config 60/60, vocabulary-schema 12/12, queue-edit 77/77). git diff
--stat -- skill-sources/ is empty; docs/field-intel-2026-08-15.md left
untracked.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.

1 participant