feature-boundary-planner
Skill37 starsChanged 57 days agoApache-2.0View on GitHub
Map a ZCode behavior change to current UI surfaces, state owners, protocol commands, persistence, and validation. Use for impact analysis, product-boundary planning, or an implementation handoff grounded in the checked-out source.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- skillpie/ZCodeOnlinetheir own version, first seen Nov 5, 2026
- ZCodium-project/ZCodiumtheir own version, first seen Nov 1, 2026
- ccbud/CCBuddytheir own version, first seen Oct 14, 2026
- betacatsling/Open-ZCodeword for word, first seen Oct 13, 2026
- zai-org/ZCodetheir own version, first seen Oct 8, 2026
Used with
Projects with it also use e2e-case-lifecycle, zcode-large-task-fixture and 1 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ZCodium-projectSkille2e-case-lifecycle
Plan, maintain, replay, and promote ZCode desktop E2E cases and their fixtures, coverage matrices, and CI admission evidence.
Also in 3 projects that use this
ZCodium-projectSkillzcode-large-task-fixture
Generate, verify, or remove large synthetic ZCode task fixtures in local ~/.zcode persistence for UI/session performance testing. Use when testing big conversation/task rendering, task list performance, snapshot recovery, tool-call rendering, reasoning, patches, todos, and model usage without spending time chatting manually.
Also in 3 projects that use this
WillhongSkillsession-management
Also in 3 projects that use this
Other versions5 projects use a version of this.
Word for word · 1
- betacatsling/Open-ZCode★ 0100% same
Edited · 0
None found.
Wrote their own version · 4
- zai-org/ZCode★ 8.7ksame name
- ZCodium-project/ZCodium★ 253same name
- ccbud/CCBuddy★ 8same name
- skillpie/ZCodeOnline★ 3same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/react-best-practices/AGENTS.mdAGENTS.md
- agent-browserSkill
- ai-elementsSkill
- architecture-governanceSkill
- dep-refsSkill
- dogfoodSkill
- electronSkill
- vercel-react-best-practicesSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Use the mode implied by the request.
- Very specific: line 36
Keep existing node IDs for unchanged semantic boundaries and add aliases for new terminology.
- Distinctive: line 48
Before handing off validation, check which tests, fixtures and commands actually exist in the target package.
- Distinctive: line 52
Use impact-brief-template.md for the relevant parts of the result:
- Very specific: line 64
Keep desktop desktop-continuous delivery separate from mobile web-remote-replayable recovery.
- Distinctive: line 66
Treat runtime state, snapshots, indexes, settings and caches as distinct until their synchronization is proven.
- Distinctive: line 67
Do not infer current functionality from a directory left behind by build artifacts, an old document, or a historical branch.
- Distinctive: line 68
Do not silently change product semantics to match an implementation discrepancy.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Feature Boundary Planner
Trace the requested behavior through the current checkout. A feature belongs in the result only when current source or an explicit new requirement supports it. Verify referenced paths and symbols before using them; do not reconstruct removed functionality from historical catalogs.
Choose The Scope
- impact-only: inspect and report without changing code or product specs.
- planning: establish behavior and acceptance cases before implementation.
- implementation-handoff: turn confirmed decisions into a bounded implementation and validation plan.
Use the mode implied by the request. Clarify only unknown decisions that materially change the scope; do not ask the user to reconfirm facts already established in this task.
Find Current Evidence
- Search aliases and node IDs in zcode-feature-graph.yaml for the user's terms. Read only matched nodes and their one-hop relationships, then verify the declared files, symbols and semantics against the current checkout. The graph is a curated seed index, not a complete feature inventory. Use source-discovery.md to fill gaps or start when there is no match. Read the relevant existing contracts and package scripts; read
DESIGN.mdfor UI work andCONTEXT.mdfor plugin-store work. - Locate the entrypoint with
rg --filesand focusedrg -nsearches. Trace direct callers withpnpm dep:refs <file>:<symbol>when the symbol is a TypeScript export. If an indexed codegraph tool is available, use it as additional evidence and verify its paths against the checkout. - Classify the change: presentation, option source, draft/default, validation, commit effect, persistence, or recovery.
- Trace each user surface separately through validation and the command that commits the change. Shared UI components do not establish shared state or side effects.
- Identify the authoritative owner, derived views, protocol boundary, persistence and failure behavior. Name the semantic reason for each upstream or downstream dependency; imports alone do not prove a product relationship.
- Inspect one meaningful semantic hop first, expanding only when an unresolved owner or caller requires it. Rank relationships as must-inspect, should-inspect, conditional, invariant-only, or evidence-only.
For stateful or asynchronous behavior, show a concise diagram:
user action → surface draft → validation → owner command → event / persistence
└── derived UI projectionMaintain The Seed Graph
Keep existing node IDs for unchanged semantic boundaries and add aliases for new terminology. Report missing seeds or changed relationships as graph-drift-candidate; static reachability alone does not establish a product dependency.
In impact-only mode, report proposed graph changes without editing files. In planning or implementation, update only verified entries within the task's scope. Follow the graph contract: check YAML parsing, unique IDs, relationship endpoints and ranks, and tracked source paths and symbols. Do not restore missing historical docs or claim test coverage from a graph entry.
Plan And Prune
In planning modes, write or update a feature spec before implementation. Create the spec directory if needed; do not assume an existing case catalog, test runner, or coverage workflow.
Select only dimensions that can change behavior: state, event, target, client mode, delivery kind, workspace identity, runtime availability and persistence source. Prefer representative and high-risk combinations over a global Cartesian product.
Classify cases as accepted, undefined, pruned, ignored, or bug-candidate. Give every pruned case an invariant or guard; leave undefined behavior as a concrete decision. Record accepted cases with setup, action, assertions and required evidence using case-planning-template.md.
Before handing off validation, check which tests, fixtures and commands actually exist in the target package. Distinguish planned tests, executed tests and admitted regression coverage. A missing test path is a gap, not coverage.
Output
Use impact-brief-template.md for the relevant parts of the result:
- behavior summary and scope;
- UI surface matrix, shared implementation and divergent behavior;
- ranked dependencies with current file/symbol evidence;
- state owners, validation points, commit commands and persistence;
- invariants and representative validation cases;
- unresolved decisions, unavailable evidence and relevant graph drift or updates.
Boundaries
- Preserve
workspaceIdentity?.trim() || workspacePathfor isolation andworkspacePathfor execution/display. - Keep desktop
desktop-continuousdelivery separate from mobileweb-remote-replayablerecovery. - Trace accepted commands to their authoritative owner; do not turn a client draft or optimistic overlay into another accepted queue.
- Treat runtime state, snapshots, indexes, settings and caches as distinct until their synchronization is proven.
- Do not infer current functionality from a directory left behind by build artifacts, an old document, or a historical branch.
- Do not silently change product semantics to match an implementation discrepancy; report the evidence and the decision needed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

