Out-of-the-box workflow templates for the Ambient Code Platform (ACP). These workflows provide structured processes for AI agents to follow when working on complex tasks.
For workflow developers: See the Workflow Development Guide for comprehensive documentation on creating and modifying workflows.
Workflows are structured configurations that guide Claude through multi-step processes. Each workflow defines:
- System prompt: Core instructions defining Claude's behavior and methodology
- Startup prompt: Initial greeting when the workflow activates
- Commands: Slash commands (e.g.,
/diagnose,/fix) for specific workflow phases - Artifacts: Output locations for generated files
The platform automatically discovers workflows from this repository. Any directory under workflows/ with a valid .ambient/ambient.json file appears in the UI.
| Workflow | Description | Commands |
|---|---|---|
| bugfix | Systematic bug resolution with reproduction, diagnosis, fix, and testing phases | /reproduce, /diagnose, /fix, /test, /document |
| triage | Issue backlog triage with actionable reports and bulk operations | Conversational |
| spec-kit | Spec-driven development for feature planning and implementation | /speckit.specify, /speckit.plan, /speckit.tasks, /speckit.implement |
| prd-rfe-workflow | Create Product Requirements Documents and break them into RFE tasks | /prd.discover, /prd.create, /rfe.breakdown, /rfe.prioritize |
| amber-interview | Collect user feedback through guided conversations | /feedback, /interview |
| template-workflow | Starter template demonstrating workflow structure | /init, /analyze, /plan, /execute, /verify |
A systematic 5-phase workflow for resolving software bugs:
- Reproduce - Confirm and document the bug behavior
- Diagnose - Perform root cause analysis
- Fix - Implement the solution
- Test - Verify with regression tests
- Document - Create release notes and update issues
Automatically invokes specialized agents (Stella for complex debugging, Neil for testing strategy) when needed.
Efficiently triage repository issue backlogs:
- Analyzes all open issues
- Generates recommendations (CLOSE, FIX_NOW, BACKLOG, NEEDS_INFO, etc.)
- Produces an interactive HTML report with accept/reject checkboxes
- Creates bulk operation scripts for executing approved actions
Specification-driven development workflow:
- Create detailed feature specifications
- Generate technical implementation plans
- Break down plans into actionable tasks
- Guide implementation with checklists
Product requirements documentation workflow:
- Discovery phase for understanding needs
- Requirements gathering
- PRD creation with structured templates
- Breakdown into Request for Enhancement (RFE) items
- Prioritization matrix
- Navigate to your session
- Open the Workflows panel
- Select a workflow from the list
- The workflow loads and displays its startup prompt
To test a workflow from a branch or external repository:
- Select "Custom Workflow..." in the UI
- Enter the Git URL, branch, and path
- Click "Load Workflow"
This is useful for:
- Testing changes before merging to main
- Using workflows from other repositories
- Development and iteration
See the Workflow Development Guide for complete instructions on:
- Workflow structure and required files
- Creating workflows from scratch or template
- Using the
workflow-creatorskill - Testing with "Custom Workflow..."
- Best practices for commands, skills, and system prompts
| Document | Purpose |
|---|---|
| WORKFLOW_DEVELOPMENT_GUIDE.md | Complete guide for workflow developers |
| AMBIENT_JSON_SCHEMA.md | ambient.json field reference |
| WORKSPACE_NAVIGATION_GUIDELINES.md | Best practices for file navigation in systemPrompts |
| AGENTS.md | Guidelines for AI agents modifying this repository |
To contribute a workflow:
- Fork this repository
- Create a new workflow directory under
workflows/ - Follow the structure guidelines
- Test using the "Custom Workflow" feature
- Submit a pull request with documentation
This repository is provided under the MIT License. See LICENSE for details.