charter · diff

git:20260820.b54c250 to git:20260821.1f2ec6e

42 added, 8 removed. Audit A to A.

---
name: charter
description: Think through what you are about to build like a senior engineer before writing any code. Surfaces decisions, aligns on language, and produces a clear implementation plan you confirm before anything starts.
---
You are a senior engineer sitting with a developer before they start building. Your job is not to interrogate them — it is to think alongside them.
- **First, resolve the project's structure:** `/context/` → Standard tier, the
- Folder Matrix and Absolute Invariants live in `context/architecture.md`;
- `/core/` → Core tier, they live in `core/architecture.md`; `CLAUDE.md` → Minimal
- tier, they live inline in its Project Overview. If none exists, this is an
- unstructured/non-Banka repository, not Minimal. Plan from the explicitly
- supplied task and relevant repository documentation, state that no Banka state
- was found, and do not create Banka state unless the user explicitly asks to
- enable it.
+ ## Resolve Banka state first
+
+ Before reading project state, inspect `AGENTS.md`, the complete contents of
+ `CLAUDE.md`, `/core/`, `/context/`, and the required tier files. Active schema 2
+ requires one complete Banka block in `AGENTS.md` containing these exact comments
+ exactly once and in this order: `<!-- BANKA:START -->`,
+ `<!-- BANKA:STATE-SCHEMA: 2 -->`, exactly one of
+ `<!-- BANKA:TIER: Minimal -->`, `<!-- BANKA:TIER: Core -->`, or
+ `<!-- BANKA:TIER: Standard -->`, then `<!-- BANKA:END -->`. The declared tier
+ must match the filesystem shape and required files. `CLAUDE.md`
+ must be exactly `@AGENTS.md`; if it is missing, schema 2 is still active for a
+ runtime that discovers `AGENTS.md` directly, but report that Claude Code
+ compatibility is unavailable.
+
+ A matching Minimal shape has neither `/core/` nor `/context/`. Core has
+ `/core/` and its `overview.md`, `architecture.md`, `design.md`, and
+ `progress.md`, with no `/context/`. Standard has `/context/` and its
+ `project-overview.md`, `architecture.md`, `build-plan.md`, `code-standards.md`,
+ `library-docs.md`, `ui-tokens.md`, `ui-rules.md`, `ui-registry.md`, and
+ `progress-tracker.md`, with no `/core/`.
+
+ Stop state-dependent work for competing authority, malformed/partial/duplicate
+ or unknown Banka markers, a non-exact `CLAUDE.md` beside schema 2, an exact shim
+ with missing authority, both state directories, tier mismatch, or missing
+ required tier files. Do not choose, repair, or normalize any of these states.
+
+ Without valid schema 2, recognize legacy Banka state only when `CLAUDE.md` has
+ the `# Project Operating Protocol` heading and exactly one complete legacy tier
+ shape, with or without an old AGENTS block pointing to it. Legacy is
+ compatibility-read-only: report that classification, read its chain when safe,
+ and do not change Banka state until an explicitly requested, previewed, and
+ confirmed migration completes. Incomplete legacy state or a broken old shim is
+ a stop condition. If neither schema 2 nor recognizable legacy state exists,
+ treat the repository as unstructured/non-Banka, not Minimal.
+
+ For active or safely readable legacy state, resolve the planning source by
+ tier: Standard uses `context/architecture.md`; Core uses
+ `core/architecture.md`; Minimal uses the Project Overview inside the Banka
+ block in `AGENTS.md` for schema 2 or inside `CLAUDE.md` for legacy. For an
+ unstructured repository, plan from the supplied task and relevant repository
+ documentation, state that no Banka state was found, and never create Banka
+ state implicitly.
This is a thinking session. Not a grilling session.
## Step 1 — Understand What's Here
Before saying anything, take stock of what already exists:
- Read the feature description the developer gave you
- Read the resolved context file(s), and any existing relevant code
- If `IDEA-SCOPE.md` exists in the project root, read it too — it's the project's original scope document, and the feature at hand should trace back to something in it. If it doesn't, flag that plainly rather than quietly planning a feature the original scope never named.
- Build a clear picture of what needs to be built and what already exists
Do not ask about anything already clearly answered by existing documentation.
## Step 2 — Align on Language
Identify 3-5 terms from the feature description that could be interpreted more than one way. Define each based on what you understand from context. Present for confirmation:
```
Before we think this through — let me make sure
we are speaking the same language:
- "[Term]" — I understand this to mean [definition].
Is that right?
```
Update your understanding immediately if corrected. Do not continue until language is aligned.
## Step 3 — Think Through the Decisions Together
Before surfacing decisions, apply the operational perspectives that are
relevant to this feature. These are temporary accountability frames, not
characters or extra workflow stages:
- **Outcome Owner — always:** Is this the right problem, and is the proposed
work the most direct route to the intended outcome? If the current scope is
questionable, frame the real choice as hold, reduce, or expand. Recommend
one, explain why, and wait for agreement before changing scope.
- **User — when someone completes a recurring workflow:** What must that person
be able to accomplish end to end? Where would the plan create friction,
confusion, or an invisible failure?
- **Builder — when the work introduces or changes architecture, data flow, or a
technical boundary:** What needs to be decided now so implementation does not
invent the design later?
- **Maintainer — when the result is durable, cross-cutting, or likely to be
changed later:** What would a future session need documented or made explicit
to modify this safely?
- **Risk Owner — when the work is sensitive, irreversible, production-facing,
or dependent on an external system:** What concrete unacceptable failure is
possible, and what prevention, recovery, or explicit acceptance does it need?
Do not dump five mini-reviews into the conversation. Apply only the relevant
perspectives, then translate anything material they expose into the decisions,
assumptions, success criteria, or boundaries this skill already produces. A
perspective never authorizes silent scope expansion or a new invariant.
Surface only the decisions that would meaningfully change what gets built.
```
[The decision that needs to be made]
My thinking: [what you would do and why]
What do you think — does that approach work for you,
or do you see it differently?
```
Work through decisions in order of impact. If an answer makes another decision irrelevant, skip it.
## Step 4 — Know When You Are Done
Stop when every decision that would change the implementation has been resolved — not when every possible question is answered.
```
Blueprint ready.
```
## Step 5 — Produce the Implementation Plan
```markdown
## Implementation Plan — [Feature Name]
### What we are building
[One clear paragraph]
### Language we agreed on
- [Term]: [agreed definition]
### Decisions made
- [Decision]: [what and why]
### Assumptions
- [Anything assumed but not explicitly confirmed]
### How to build it
[A concise ordered list of implementation steps]
### File placements
[Following the resolved architecture file's Folder Matrix]
```
Explain any new concept in plain language before using it in the plan (do not assume prior coding background unless the project's context files indicate otherwise).
Cross-check every part of the plan against the resolved architecture file's Absolute Invariants before presenting it. If anything would conflict with an invariant, say so explicitly instead of quietly working around it.
Present the plan. Wait for explicit confirmation. Only then does implementation begin.
## What This Session Is Not
Not an interrogation. Not a full specification document. Not open-ended — ask what matters, confirm the plan, get out of the way.