agentslice
v1.0.0
Published
A Markdown workflow kit that makes Cursor, Claude Code, Codex and Windsurf ask before they edit.
Maintainers
Readme
Quick start
npx agentslice init
# Paste INSTALL_PROMPT.md into Cursor / Claude Code / Codex / Windsurf
# Watch the agent ask, plan, and waitThat's it. No build step, no runtime, no editor extension.
30-second demo
What it does
AI coding agents work better when they know the next step. Without a workflow they suffer from three failure modes developers describe constantly:
- Context drift — the agent forgets what was decided two messages ago and reopens settled questions.
- Wandering edits — the agent expands the task, touches files you didn't ask about, and burns tokens on detours.
- Editing without asking — the agent jumps straight to changes before you've approved a plan.
AgentSlice gives the agent a project-local workflow it actually reads: a tiny set of Markdown files that pin down the phases, the gates, and the next required action so the agent asks first, plans first, and waits for approval before it edits.
What's in the kit
| File | Purpose |
|---|---|
| INSTALL_PROMPT.md | The one prompt you paste into your AI tool to bootstrap the workflow. |
| docs/planning/workflow-state.md | Resumable state file — current phase, approved slice, QA status, next allowed action. |
| .agents/skills/ | Shared planning skills: intake, slice planning, spec, QA gate, release, advance. |
| .cursor/rules/ | Project rules for Cursor. |
| .claude/skills/ + CLAUDE.md | Skills and project memory for Claude Code. |
| .codex/skills/ + AGENTS.md | Skills and project rules for Codex. |
| .windsurf/rules/ + .windsurfrules | Rules for Windsurf. |
Everything is plain Markdown. You can read it, fork it, edit it for your stack.
Supported tools
Cursor · Claude Code · Codex · Windsurf · OpenCode · any agent that respects project-level rule files (AGENTS.md, CLAUDE.md, .cursor/rules/, .windsurfrules).
How it works
Ask → Plan → Approve → Build → QA → Release → Next- Ask. The agent asks up to five product questions and writes lightweight context.
- Plan. It proposes a first slice — the smallest end-to-end vertical you can ship.
- Approve. You approve, reject, or adjust the slice. The agent waits.
- Build. Only after approval does the agent write code.
- QA. The agent (or a QA subagent, where supported) checks the work and reports PASS / PASS WITH NOTES / FAIL.
- Release. A release recommendation is written. You approve.
- Next. The state file advances to the next slice. The loop repeats.
The state lives in docs/planning/workflow-state.md so the next agent session resumes from a real checkpoint instead of re-guessing.
Stack Packs
The Core kit handles any stack. Stack Packs are pre-tuned slice templates, spec patterns and QA scripts for specific stacks — the kind of fine-tuning that would otherwise take you 2-3 hours per project.
- Next.js Pack
- Python / FastAPI Pack
- Rails Pack
- React Native Pack
- Go services Pack
- AI / LLM apps Pack
$29 each. $99 for the full bundle. Founding-buyer pricing for the first 100.
Browse Stack Packs at getagentslice.com/packs →
For Teams
AgentSlice for Teams is a multi-seat license with private fork support, quarterly office hours, early access to new patterns, and a seat at the roadmap table.
- Up to 10 seats per team
- $299 / year
- For teams that want a single shared agent workflow across the org
Learn more at getagentslice.com/teams →
Why open source after 7 months
A short note from Espen:
I spent seven months iterating on this workflow as a paid
$29ZIP. The product was right. The shape was wrong. The category norm in 2026 is open, forkable, and community-driven —awesome-cursorruleshas 27k stars, BMAD is open source, shadcn made free components into a category. Charging for Markdown puts you on the wrong side of the community ethics, and dev-tool buyers feel it.The real value was never the files. It was the opinionated workflow — the intake questions, the slice discipline, the QA handoff, the cross-tool consistency. That's worth far more than $29 to a team and far less than $0 to an indie who'll fork it anyway. So the Core kit is now free and MIT, and I monetize the edges: Stack Packs, Teams, consulting.
If you found this through a friend, a tweet, or a search result — that's the whole point.
Why no runtime, why just Markdown
AgentSlice is deliberately not an editor extension, daemon, or hook system. Two reasons:
- Portability. The same files work in Cursor, Claude Code, Codex, Windsurf, OpenCode, and any future agent that reads project rules. A runtime would lock you into one tool.
- Honesty. No Markdown file can force an LLM to obey. The gates are soft — discipline through clarity, not enforcement. AgentSlice is up-front about this. The workflow is durable because it lives in your repo, not because it traps the model.
If you need hard enforcement, pair AgentSlice with Cursor's PLAN / ASK toggle or Claude Code's hooks. AgentSlice gives the agent the workflow; your tool of choice can add the gates.
Contributing
PRs, issues, and discussion are all welcome. See CONTRIBUTING.md for guidelines.
The fastest way to help: open an issue with the exact prompt + tool + transcript where AgentSlice misbehaved. Real failure transcripts are gold for tuning the rules.
License
MIT. Use it however you want — personal projects, client work, internal tooling, your own product. If you build something on top of AgentSlice, a link back is appreciated but not required.
Maintainer
Built and maintained by Espen Andreassen. Reach out at [email protected] or open a discussion.
Sponsor
If AgentSlice saves you time, consider sponsoring on GitHub. Sponsorships fund maintenance, new Stack Packs, and keep the Core kit free.
