Trailmark v1.0.0 — first stable public release
Trailmark is an artifact-first agent framework for Claude Code. Every step of every skill writes a first-class file and registers in routing.db. If a step didn't produce an artifact — it didn't happen.
Chat log → auditable engineering record. One rule, enforced by protocol.
What's in v1.0.0
19 shipped skills + 1 tool across 3 tiers:
- 2 slash-commands:
/go-start,/go-fast - 4 protocol skills:
idea-first,arch-first,audit-first,ui-ai-first - 13 core skills:
flow-first,library-first,plan-first,ship-first,human-first,decision-first,note-first,dev-auto-first,cadence-first,arch-map,check-first,go-guide,tutorial-check - 1 tool: Flow UI (local read-only browser over
routing.db)
Highlights
- Onboarding in 5 minutes —
bash bin/init→bash bin/init-demo→bash bin/new-project→ real work in the same session - Demo lifecycle with 3-marker safety —
init-demopopulates 3 projects × 2 tasks (123 rows),archive-demoremoves cleanly with zero-touch guarantee for your real data - Homework validator —
/tutorial-checkruns 5 SQL/file checks to confirm you've internalized the loop - Auditable per-block cycle —
flow-first → library-first → plan-first → execute → ship-firstwith per-block cadence assignment - Flow UI at
127.0.0.1:8765— visual browser over your task tree, no CLI queries needed
Install
git clone https://github.com/bearded-illirian/trailmark
cd trailmark
bash bin/init
bash bin/init-demo
bash bin/new-project my-first-appThree commands, ~1 minute. Full walkthrough: docs/QUICKSTART.md.
Documentation
README·README.ru— hero + orientationdocs/CONCEPTS.md— glossarydocs/QUICKSTART.md— 5-step walkthroughdocs/SKILLS_MAP.md— every shipped skilldocs/TROUBLESHOOTING.md— top 7 failure modesCHANGELOG.md— full history
For whom
Solo or small-team engineers using Claude Code (or any agent supporting Skill('name')), who want an audit trail across many blocks, weeks, and sessions — and prefer plain markdown + bash + git over new SDKs.
License
MIT — see LICENSE.
Community welcome via Discussions.