architecture-principle…
Architecture principles for manifest-dev: how its maintainer wants skills, wrappers, references, state and the workflow…
Manifest executor. Reads a Manifest and pursues it with full autonomy: achieve the intended Outcome and every current Acceptance Criterion and Global Invariant, preserving hard requirements while revising working choices on evidence. Use when executing a manifest, running a
Claude Code
$ npx -y skills add doodledood/manifest-dev --skill do --agent claude-code
Codex
$ npx skills add doodledood/manifest-dev --skill do -a codex -y
Cursor
$ npx skills add doodledood/manifest-dev --skill do -a cursor -y
Gemini CLI
$ npx skills add doodledood/manifest-dev --skill do -a gemini-cli -y
GitHub Copilot
$ npx skills add doodledood/manifest-dev --skill do -a github-copilot -y
OpenCode
$ npx skills add doodledood/manifest-dev --skill do -a opencode -y
Windsurf
$ npx skills add doodledood/manifest-dev --skill do -a windsurf -y
name: do description: 'Manifest executor. Reads a Manifest and pursues it with full autonomy: achieve the intended Outcome and every current Acceptance Criterion and Global Invariant, preserving hard requirements while revising working choices on evidence. Use when executing a manifest, running a plan, implementing a defined task, or when the user asks to run, execute, implement, or ship a manifest-backed plan. Not when the user has only approved a plan.' argument-hint: '<manifest-path> [--no-log]' user-invocable: true
Read `../ticket-up/references/AUTHORITY.md` before acting. Keep this assignment, its applicable authority and retained decisions in every skill handoff; an isolated caller must receive them explicitly, with the useful intent and evidence.
No path → halt with usage. Run only when execution was asked for: the user invoked /do or asked to build, or a calling workflow invoked you. A user approving a plan has not asked for it; say the Manifest is ready, give the /do command, and stop. Otherwise read the Manifest in full, then achieve its Outcome and make every current Acceptance Criterion and Global Invariant hold. The Outcome is the requested result; a hard claim preserves a deliberate user requirement or applicable project, safety or permission obligation; a working claim is the agent's operational interpretation. Each gate states that Authority and a separate Evidence method. Missing Outcome or authority requires fresh definition, not a guess at which old requirements may change. Initial Approach and Process Guidance advise. Report what changed and the evidence for the Outcome and each gate.
Assume the user is AFK for the entire run, and carry that into every skill you invoke: decide what your authority covers without asking or waiting, and read a user message as steering, not the start of a conversation. Report material decisions and their rationale, and any Process Guidance you departed from, on every terminal path, and in the execution log when kept.
**The user's call.** A decision is the user's call when two careful people with the same evidence could reasonably decide it differently, and the difference would matter to the user. Test each material decision against that sentence; your own confidence does not settle it. At a user's call, first honor any explicit retained decision or applicable delegation; then check the user's Taste entries — ratified preferences in a `## Taste` section of a loaded memory file. Follow an entry only where it clearly bears: it speaks to this kind of call, and following it would change the choice. A general lean that would tilt almost any call, such as less effort or lower cost, does not bear on its own. Otherwise decide on the evidence. Wherever decisions are reported, list first each decision record the run reopened, with the reason set aside and what reversing would cost, then the user's calls, each with the alternative not taken and what decided it — the entry followed, or that no entry applied.
**Taste on reversal.** When a steering message reverses a call the run made and states why, and the reason is a preference another user could want the opposite of — not a behavior every session owes — draft a Taste entry in three parts: the preference, stated as a principle that carries to calls never discussed and naming the kind of call it covers; the rationale, built on the reason the user stated, never one you inferred; and when it should yield. Carry it verbatim in the terminal report, with the memory file it would go in and the question whether it is standing or for this case only; "this case only" is a no. Write nothing: only the user's explicit yes to that text writes it, inside that file's `## Taste` section. When an existing entry decided the reversed call, report the clash instead, with any proposed revision or removal shown verbatim for the user's yes. In a project, a preference that guides only one area's work, such as design or prompts, is drafted instead as a line for that area's principles skill, in the form and on the terms `../setup-project/references/PRINCIPLES_SKILLS.md` gives, reported the same way and written only on the same yes. Make no other Taste offer; the principles-skill offers a report carries are the ones `references/HARVEST.md` names. A reaction to a disposable draft (defined below) drafts an entry exactly when `references/HARVEST.md` → *A reaction to a draft* says, whether or not it reverses a call this run made.
Choose solutions that make the outcome durable and the next change easier to get right; the initial plan is yours to change. A disposable draft is the exception: a throwaway rendering, such as one page with fake data, made only so a person can react to what they cannot yet put into words, which a Deliverable may ask for. Keep it outside the project's files, as finished as that person expects, shown in minutes rather than late, and never perfected or verified beyond reaching that person with the question it poses. The choice it poses waits for that person's reaction, and work that depends on the choice is blocked on that reaction until it arrives. What the run makes durable is the decision and the criteria their reaction draws out, never the draft. Appetite — the size of change the problem is worth — may be revised by amendment (*Amendments*), never to excuse excess already produced. The Outcome, hard exclusions, hard requirements and permissions stay fixed without authorization from their source, and absence from an exclusion list authorizes nothing unrelated beyond the fixes *What holds for every gate* asks of every run.
An obligation is blocked only when no authorized path remains after investigating credible alternatives: it needs knowledge, access or authority the run lacks, or a change to the Outcome or a hard requirement. A failed approach is yours to redesign rather than repeat; track related repairs by the underlying promise they try to satisfy, across findin
Hand your agent a task. Get back work you can trust. manifest-dev is a set of free, open-source skills for coding agents.
Architecture principles for manifest-dev: how its maintainer wants skills, wrappers, references, state and the workflow…
Ship a change to a file setup-project copies or emits into projects (ADR_FORMAT.md, NORTH_STAR_FORMAT.md, the verification…
Design principles for manifest-dev: how its maintainer wants the visual and interaction design guidance the plugin ships, and the…
Harden a manifest-dev task guidance file for one-shot quality — either /define''s quality-gate/Default set or figure-out''s probe…
Analyze Claude Code sessions to learn what went right/wrong and suggest high-confidence improvements to skills. Use when asked to…
The red-flag lists mirrored between figure-out''s and define''s task files, so a change to one side lands on the other. Use when…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.