ACE - Handbook

Standardized workflows for creating and managing guides, cookbooks, workflow instructions, and agent definitions. 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-handbook demo

ace-handbook gives ACE teams a shared way to author, review, and maintain handbook assets with consistent quality gates and repeatable delivery workflows. It covers guides (.g.md), cookbooks (.cookbook.md), workflow instructions (.wf.md), and agent definitions (.ag.md).

How It Works

  1. Author handbook assets using standardized templates and structure conventions for guides, workflows, and agents.
  2. Review content through quality-gate workflows that check clarity, formatting, and process compliance.
  3. Coordinate multi-step documentation changes through orchestration and research workflows.

Use Cases

Author handbook assets with consistent structure - use /as-handbook-manage-guides, /as-handbook-manage-cookbooks, /as-handbook-manage-workflows, and /as-handbook-manage-agents to create and update guides, cookbooks, workflow instructions, and agent definitions with package workflows.

Review handbook content before publishing - run /as-handbook-review-guides, /as-handbook-review-cookbooks, and /as-handbook-review-workflows to catch clarity, formatting, and process issues before updates propagate to integrations.

Coordinate larger handbook deliveries - use /as-handbook-update-docs to plan, execute, and synthesize multi-step documentation changes across package handbook assets.

Integrate with resource discovery and context loading - pair with ace-nav for workflow and resource discovery, ace-bundle for loading complete workflow instructions, and provider integrations (ace-handbook-integration-*) that project canonical handbook skills into provider-native folders.

Sync and inspect provider integrations - run ace-handbook sync to project canonical skills into provider-native folders and ace-handbook status to check integration health across all configured providers.

Extend handbook content in normal projects - put project-specific workflows, guides, cookbooks, templates, and skills under .ace-handbook/ and discover them with protocol URLs (wfi://, guide://, cookbook://, tmpl://, skill://). See Usage Guide for path conventions.

Testing

  • ace-test ace-handbook runs the deterministic fast suite (test/fast).
  • ace-test ace-handbook feat runs deterministic feature tests (test/feat) when present.
  • ace-test ace-handbook all runs all deterministic layers for the package.
  • ace-test-e2e ace-handbook runs retained workflow scenarios under test/e2e.

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