ace-experience 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Lex Christopherson
+Copyright (c) 2026 Ash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# ACE — Agentic Code Experience
+
+A stage-driven, context-engineered agentic code execution system for Claude Code, OpenCode, and Gemini.
+
+ACE gives your AI coding assistant a structured workflow: stages, tasks, state management, and specialized agents — so it builds your project methodically instead of wandering.
+
+## Install
+
+```bash
+npx ace-experience
+```
+
+The installer walks you through setup — pick global or local install, choose your AI tool (Claude Code, OpenCode, Gemini, or all), and ACE copies the commands, agents, and workflows into the right place.
+
+## What you get
+
+- **25 slash commands** — structured actions like `/ace.run-stage`, `/ace.add-todo`, `/ace.audit`
+- **11 specialized agents** — architect, runner, detective, auditor, and more
+- **12 workflows** — reusable processes the commands delegate to
+- **State files** — `pulse.md` (living memory), `track.md` (stage structure), `brief.md` (project context)
+
+## How it works
+
+1. **Initialize** — `/ace.init` sets up your project with a brief and stage structure
+2. **Plan** — `/ace.plan-stage` breaks a stage into concrete tasks
+3. **Build** — `/ace.run-stage` executes tasks with autonomous agents
+4. **Track** — State files keep context across sessions so nothing gets lost
+
+## Requirements
+
+- Node.js 16.7+
+- One of: Claude Code, OpenCode, or Gemini CLI
+
+## Acknowledgments
+
+Built on ideas from [Get Shit Done](https://github.com/glittercowboy/get-shit-done) by Lex Christopherson.
+
+## License
+
+[MIT](LICENSE)

package/ace/references/continuation-format.md

@@ -0,0 +1,249 @@
+# Continuation Format
+
+Standard format for presenting next steps after completing a command or workflow.
+
+## Core Structure
+
+```
+---
+
+## ▶ Next Up
+
+**{identifier}: {name}** — {one-line description}
+
+`{command to copy-paste}`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `{alternative option 1}` — description
+- `{alternative option 2}` — description
+
+---
+```
+
+## Format Rules
+
+1. **Always show what it is** — name + description, never just a command path
+2. **Pull context from source** — track.md for stages, run.md `<objective>` for runs
+3. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
+4. **`/clear` explanation** — always include, keeps it concise but explains why
+5. **"Also available" not "Other options"** — sounds more app-like
+6. **Visual separators** — `---` above and below to make it stand out
+
+## Variants
+
+### Execute Next Run
+
+```
+---
+
+## ▶ Next Up
+
+**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+
+`/ace.run-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- Review run before executing
+- `/ace.list-stage-assumptions 2` — check assumptions
+
+---
+```
+
+### Execute Final Run in Stage
+
+Add note that this is the last run and what comes after:
+
+```
+---
+
+## ▶ Next Up
+
+**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+<sub>Final run in Stage 2</sub>
+
+`/ace.run-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**After this completes:**
+- Stage 2 → Stage 3 transition
+- Next: **Stage 3: Core Features** — User dashboard and settings
+
+---
+```
+
+### Plan a Stage
+
+```
+---
+
+## ▶ Next Up
+
+**Stage 2: Authentication** — JWT login flow with refresh tokens
+
+`/ace.plan-stage 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/ace.discuss-stage 2` — gather context first
+- `/ace.research-stage 2` — investigate unknowns
+- Review track
+
+---
+```
+
+### Stage Complete, Ready for Next
+
+Show completion status before next action:
+
+```
+---
+
+## ✓ Stage 2 Complete
+
+3/3 runs executed
+
+## ▶ Next Up
+
+**Stage 3: Core Features** — User dashboard, settings, and data export
+
+`/ace.plan-stage 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/ace.discuss-stage 3` — gather context first
+- `/ace.research-stage 3` — investigate unknowns
+- Review what Stage 2 built
+
+---
+```
+
+### Multiple Equal Options
+
+When there's no clear primary action:
+
+```
+---
+
+## ▶ Next Up
+
+**Stage 3: Core Features** — User dashboard, settings, and data export
+
+**To plan directly:** `/ace.plan-stage 3`
+
+**To discuss context first:** `/ace.discuss-stage 3`
+
+**To research unknowns:** `/ace.research-stage 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+### Milestone Complete
+
+```
+---
+
+## 🎉 Milestone v1.0 Complete
+
+All 4 stages shipped
+
+## ▶ Next Up
+
+**Start v1.1** — questioning → research → requirements → track
+
+`/ace.new-milestone`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+## Pulling Context
+
+### For stages (from track.md):
+
+```markdown
+### Stage 2: Authentication
+**Goal**: JWT login flow with refresh tokens
+```
+
+Extract: `**Stage 2: Authentication** — JWT login flow with refresh tokens`
+
+### For runs (from track.md):
+
+```markdown
+Runs:
+- [ ] 02.03: Add refresh token rotation
+```
+
+Or from run.md `<objective>`:
+
+```xml
+<objective>
+Add refresh token rotation with sliding expiry window.
+
+Purpose: Extend session lifetime without compromising security.
+</objective>
+```
+
+Extract: `**02.03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry`
+
+## Anti-Patterns
+
+### Don't: Command-only (no context)
+
+```
+## To Continue
+
+Run `/clear`, then paste:
+/ace.run-stage 2
+```
+
+User has no idea what 02.03 is about.
+
+### Don't: Missing /clear explanation
+
+```
+`/ace.plan-stage 3`
+
+Run /clear first.
+```
+
+Doesn't explain why. User might skip it.
+
+### Don't: "Other options" language
+
+```
+Other options:
+- Review track
+```
+
+Sounds like an afterthought. Use "Also available:" instead.
+
+### Don't: Fenced code blocks for commands
+
+```
+```
+/ace.plan-stage 3
+```
+```
+
+Fenced blocks inside templates create nesting ambiguity. Use inline backticks instead.