waymark
AGENTS.md112 starsChanged 11 days agoApache-2.0View on GitHub
The tracker is Waymark itself; tickets live under tickets/ and are managed by the waymark CLI, not by Clove. The design map is tickets/map/wm-y14hs95k8wct.md. When grilling, domain-modeling, or otherwise clarifying Waymark behavior, record every settled feature decision in that design map as soon as it is resolved. Do not defer, batch, or compress settled decisions into a few vague summary bullets: capture the concrete rules, constraints, exceptions, and examples needed to guide the functional specification and implementation tickets. Keep unresolved…
In this repository48 other files it gives its agents.
- waymark/AGENTS.mdAGENTS.md
- accessibilitySkill
- animateSkill
- ask-mattSkill
- chief-of-staffSkill
- claude-handoffSkill
- codebase-designSkill
- code-reviewSkill
- design-taste-frontendSkill
- diagnosing-bugsSkill
- domain-modelingSkill
- emil-design-engSkill
- find-animation-opportunitiesSkill
- frontend-designSkill
- git-guardrails-claude-codeSkill
- grillingSkill
- grill-meSkill
- grill-with-docsSkill
- handoffSkill
- implementSkill
- implement-specSkill
- improve-animationsSkill
- improve-codebase-architectureSkill
- improve-uiSkill
- loop-meSkill
- migrate-to-shoehornSkill
- prototypeSkill
- prSkill
- researchSkill
- retroSkill
- scaffold-exercisesSkill
- setup-matt-pocock-skillsSkill
- setup-pre-commitSkill
- setup-ts-deep-modulesSkill
- tddSkill
- teachSkill
- to-questionnaireSkill
- to-specSkill
- to-ticketsSkill
- triageSkill
- wait-whatSkill
- wayfinderSkill
- web-design-guidelinesSkill
- wizardSkill
- writing-beatsSkill
- writing-for-agentsSkill
- writing-fragmentsSkill
- writing-shapeSkill
The file
Files
Agent instructions
Waymark design work
The tracker is Waymark itself; tickets live under tickets/ and are managed by the waymark CLI,
not by Clove. The design map is tickets/map/wm-y14hs95k8wct.md.
When grilling, domain-modeling, or otherwise clarifying Waymark behavior, record every settled feature decision in that design map as soon as it is resolved. Do not defer, batch, or compress settled decisions into a few vague summary bullets: capture the concrete rules, constraints, exceptions, and examples needed to guide the functional specification and implementation tickets. Keep unresolved questions in the unresolved section; update the map inline after each confirmed round, before asking the next round. Do not update the functional spec or implementation tickets until the user asks for that synchronization or confirms the design is ready. After completing requested file changes, commit them; inspect the staged diff and use a concise commit message that describes the change.
Hand-edit work-item frontmatter only through the CLI (waymark create, waymark body, waymark status, …). A document written without the required created_at/updated_at keys makes the projection incomplete and breaks the read-only Web view with INCOMPLETE_PROJECTION.
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.

