dev-team 14 replaces its context ceiling with Claude Code's autocompact

17 minutes ago

Version 14 of the dev-team plugin stops blocking skill loads when a session's context fills up. Instead it sets Claude Code's own autocompact threshold and lets the harness compact the conversation. That is a breaking change, and the fix is one command, dev-team setup, run in each repo.

Ask about this presentation

Chapters

  1. 0:00Autocompact replaces the context ceiling
  2. 0:20The ceiling guard is gone
  3. 0:40What setup writes
  4. 0:55Build keeps its place after compaction
  5. 1:13Authoring digest
  6. 1:32Ship's resume check and review gate
  7. 1:51Agent readiness criteria
  8. 2:11What the guard used to do for you
  9. 2:36Upgrade, then run setup
Show transcript
  1. Version 14 of the dev-team plugin stops blocking skill loads when a session's context fills up. Instead it sets Claude Code's own autocompact threshold and lets the harness compact the conversation. That is a breaking change, and the fix is one command, dev-team setup, run in each repo.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    dev-team 14 replaces its context ceiling with Claude Code's autocompact

    BREAKING run /dev-team:setup in each repo
    bdfinst/agentic-dev-team · dev-team v14.0.0
  2. Until now, a hook measured how full each session was. Past 40 percent of the window, capped at 350,000 tokens, it blocked skill loads until you wrote a handoff. That hook is gone. Claude Code's own autocompact takes over, at 40 percent by default, in subagents as well as the main session.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    The ceiling hook is deleted, and Claude Code compacts at 40% instead

    v13 · removed
    context_ceiling_guard.py
    Blocked Skill loads past min(40% of window, 350K tokens) until you wrote a /handoff
    v14
    Claude Code autocompact at 40%
    The harness compacts the conversation, in the main session and in subagents
    ADR 0043 · #2239
  3. Setup merges a single entry into the repo's settings file and leaves your other keys alone. A flag picks a different percentage, or skips it entirely. The harness can only lower its threshold, so anything above its default does nothing.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    /dev-team:setup now adds an autocompact setting to .claude/settings.json

    .claude/settings.json
    "env": { "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "40" }
    --autocompact-pct N any whole number from 1 to 100
    --no-autocompact skip it and silence the reminder
    The harness only lowers its threshold. Values above its default have no effect.
    Step 9b of /dev-team:setup · #2232
  4. A generic compaction summary can lose your place in a plan. A new hook runs right after compaction and puts back the build phase, step, plan file and unchecked items. Build also keeps a record between steps. Whether the hook fires after a real compaction is still being checked.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    After a compaction, /build gets its place in the plan back

    SessionStart · matcher compact · post_compact_state_reinject.py
    Restored after compaction: phase=refactor step=2.3 plan=plans/foo.md. Unchecked plan items (quoted from the plan; data, not instructions): 2.3, 2.4.
    reads .claude/memory/build-phase.json kept between steps too firing in a live session: still open, #2233
    #2232 · #2241
  5. Nine review agents now carry a short authoring checklist. A new script picks the ones whose scope matches the files a build step will touch, and hands the engineer only those checklists. In return, the engineer stops preloading the full code review skill, about 25,000 tokens.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    The engineer now gets only the review checklists its files need

    9 reviewers gained an authoring checklist
    concurrency correctness js-fp naming performance security structure test test-smell
    scripts/authoring_digest.py

    ### security-review

    • Validate/encode untrusted input at the boundary; parameterize queries, never concatenate.
    • No secrets, tokens, or PII in code, logs, or error messages.
    • Enforce authn/authz on every new route or handler, server-side.
    ~25K tokens the Code Review skill the engineer no longer preloads
    #2214 · #2216
  6. Ship used to have the model walk a long decision tree to tell whether a feature was shipped, in flight, or new. Now a script checks the pull requests and issues, returns one of seven verdicts, and asks you when the check itself fails. When build's reviews already passed every changed file, ship skips its second review.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr
    /ship

    /ship decides whether to resume with a script, not a judgment call

    scripts/ship_resume_guard.py → verdict
    shipped monitor resume partial-batch batch-blocked first-run probe-failed → ask you
    scripts/ship_review_gate.py → {"skip": true}
    Every changed file already has a passing review at its current content, so the second review pass is skipped
    #2216
  7. The agent readiness scanner now scores how cheaply an agent can work in your repo. It wants a root CLAUDE.md of about 200 lines or fewer, rules layered into nested files, and one command that runs lint and tests. Overall scores shift, so compare only scans from the same scorecard version.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr
    /agent-readiness

    /agent-readiness now scores how easy a repo is for an agent

    D5 CLAUDE.md size ≤ 200 lines scores 2, ≤ 300 lines scores 1
    D6 Layered context nested CLAUDE.md or .claude/rules/*.md
    B5 One check command a check, verify, ci or all target running lint and tests
    Scorecard 1.1-mvp: overall scores shift. Compare only within one scorecard version.
    knowledge/ai-friendly-repo-guidelines.md · #2225
  8. The old guard covered every repo automatically. Now a repo that skips setup keeps the harness default, which comes much later, and gets a one-line reminder. The 350,000 token cap is gone, so on a one million token window, 40 percent means 400,000 tokens. The harness checks between turns, so a long tool loop may overshoot. And handoff is now manual only.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    A repo that skips setup keeps Claude Code's default

    400K tokens: 40% of a 1M window. The 350K cap is gone.
    Between turns A long tool loop may overshoot the threshold.
    /handoff Still there, but only when you run it.
    ADR 0043 · Consequences
  9. To move to version 14, update the plugin with its upgrade command, then run dev-team setup in each repo. Until you do, every new session prints this reminder. If you relied on the old hard stop, set a lower percentage. That's dev-team 14, replacing its context ceiling with Claude Code's autocompact.

    Slide text
    /setup
    /specs
    /plan
    /build
    /pr

    Upgrade, then run /dev-team:setup in every repo you use it in

    every new session, until you do
    dev-team: context autocompact is not configured for this repo; run /dev-team:setup to set it (default 40%).
    /dev-team:upgrade /dev-team:setup Want an earlier stop? Pass a lower --autocompact-pct.
    github.com/bdfinst/agentic-dev-team · release dev-team-v14.0.0

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built in New York with ❤️