ACE - Prompt Prep

Prepare prompts in a structured workspace with optional LLM enhancement and bundled project context. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates

ace-prompt-prep demo

ace-prompt-prep helps developers and coding agents keep prompt authoring repeatable: initialize templates, archive every revision, enrich prompt context with ace-bundle, and optionally run enhancement through ace-llm. Use /as-prompt-prep to drive the full workflow from inside a coding agent.

How It Works

  1. Initialize a prompt workspace from templates with ace-prompt-prep setup, optionally scoping to a task via --task and ace-task.
  2. Process the prompt to inject bundled context from ace-bundle sources, archive the previous version, and write output.
  3. Optionally enhance the prompt through ace-llm with --enhance and model selection before handing it to an agent or API.

Use Cases

Keep prompt history without manual bookkeeping - initialize and process prompts in a stable workspace where archives and _previous.md are maintained automatically.

Improve prompt quality before execution - run --enhance with model selection via ace-llm to rewrite prompts for clarity and completeness before handing them to an agent.

Inject project context directly into prompts - use bundle frontmatter sources so prompts include selected files, presets, and command output from ace-bundle at processing time.

Scope prompts to tasks - use --task to route prompt workspaces into ace-task directories, keeping prompts connected to delivery work alongside ace-git branch workflows.

Testing

Use the restarted package testing contract:

  • ace-test ace-prompt-prep for deterministic fast tests
  • ace-test ace-prompt-prep feat for deterministic feature-level tests
  • ace-test ace-prompt-prep all for complete deterministic coverage
  • ace-test-e2e ace-prompt-prep for retained workflow-value scenarios

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates | Part of ACE