ace-handbook 0.19.0

data/handbook/skills/as-release-rubygems-publish/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: as-release-rubygems-publish
+description: Publish ACE gems to RubyGems.org in dependency order
+# bundle: wfi://release/rubygems-publish
+# agent: general-purpose
+user-invocable: true
+allowed-tools:
+  - Bash(gem:*)
+  - Bash(ace-bundle:*)
+  - Read
+argument-hint: "[gem-name...] [--dry-run]"
+last_modified: 2026-03-21
+source: ace-handbook
+integration:
+  targets:
+    - claude
+    - codex
+    - gemini
+    - opencode
+    - pi
+  providers:
+    claude:
+      frontmatter:
+        context: fork
+        model: haiku
+assign:
+  source: wfi://release/rubygems-publish
+  steps:
+    - name: publish-gems
+      description: Publish ACE gems to RubyGems.org in dependency order
+      intent:
+        phrases:
+          - "publish gems"
+          - "push to rubygems"
+          - "publish to rubygems"
+      tags: [release, rubygems, publishing]
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://release/rubygems-publish
+---
+
+## Arguments
+
+Use the skill `argument-hint` values as the explicit inputs for this skill.
+
+## Variables
+
+None
+
+## Execution
+
+- You are working in the current project.
+- Run `ace-bundle wfi://release/rubygems-publish` in the current project to load the workflow instructions.
+- Read the loaded workflow and execute it end-to-end in this project.
+- Follow the workflow as the source of truth.
+- Do the work described by the workflow instead of only summarizing it.
+- When the workflow requires edits, tests, or commits, perform them in this project.

data/handbook/skills/as-release-update-changelog/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: as-release-update-changelog
+description: Update CHANGELOG.md with recent changes following Keep a Changelog format
+# bundle: wfi://release/update-changelog
+# agent: general-purpose
+user-invocable: true
+allowed-tools:
+  - Bash(ace-git:*)
+  - Bash(ace-bundle:*)
+  - Read
+  - Edit
+argument-hint: [change-description]
+last_modified: 2026-01-10
+source: ace-handbook
+integration:
+  targets:
+    - claude
+    - codex
+    - gemini
+    - opencode
+    - pi
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://release/update-changelog
+---
+
+Load and run `ace-bundle wfi://release/update-changelog` in the current project, then follow the loaded workflow as the source of truth and execute it end-to-end instead of only summarizing it.

data/handbook/templates/completed-work-documentation.md

@@ -0,0 +1,59 @@
+## Behavioral Context
+
+**Issue**: [Describe the issue or need that prompted this work]
+
+**Key Behavioral Requirements**:
+- [What behavior needed to change or be fixed]
+- [What the system should do after the fix]
+- [Any constraints or considerations]
+
+## Objective
+
+[One-sentence summary of what was accomplished]
+
+## Scope of Work
+
+- [Bullet point summary of changes made]
+- [Another change]
+- [And another]
+
+### Deliverables
+
+#### Create
+- [New files created, if any]
+
+#### Modify
+- [Files that were modified]
+- [With brief description of changes]
+
+#### Delete
+- [Files removed, if any]
+
+## Implementation Summary
+
+### What Was Done
+
+- **Problem Identification**: [How the issue was discovered]
+- **Investigation**: [Key findings during analysis]
+- **Solution**: [The approach taken to fix it]
+- **Validation**: [How the fix was tested]
+
+### Technical Details
+
+[Include relevant code changes, configuration updates, or architectural decisions]
+
+### Testing/Validation
+
+```bash
+# Commands used to test the fix
+[test command]
+```
+
+**Results**: [What the testing showed]
+
+## References
+
+- Commits: [commit hashes and messages]
+- Related issues: [if any]
+- Documentation: [any docs updated]
+- Follow-up needed: [if any]

data/handbook/templates/cookbooks/cookbook.template.md

@@ -0,0 +1,237 @@
+---
+doc-type: template
+title: "[Category] Cookbook: [Descriptive Name]"
+purpose: Documentation for ace-handbook/handbook/templates/cookbooks/cookbook.template.md
+ace-docs:
+  last-updated: 2026-01-08
+  last-checked: 2026-03-21
+---
+
+# [Category] Cookbook: [Descriptive Name]
+
+**Created**: YYYY-MM-DD
+**Last Updated**: YYYY-MM-DD
+**Category**: [integration | setup | migration | debugging | automation | pattern]
+**Audience**: [beginner | intermediate | advanced]
+**Estimated Time**: [X hours/minutes]
+
+## Purpose
+
+Brief description of what this cookbook accomplishes and why it's valuable.
+
+## Prerequisites
+
+**System Requirements:**
+- Requirement 1
+- Requirement 2
+
+**Knowledge Requirements:**
+- Knowledge area 1
+- Knowledge area 2
+
+**Tools & Dependencies:**
+- Tool/dependency 1
+- Tool/dependency 2
+
+## Overview
+
+High-level summary of the approach and main steps involved.
+
+## Steps
+
+### Step 1: [Step Title]
+
+**Objective**: What this step accomplishes
+
+**Commands/Actions:**
+```bash
+# Command examples with explanation
+command --option value
+```
+
+**Expected Output:**
+```
+Sample output that confirms success
+```
+
+**Validation:**
+```bash
+# Commands to verify this step completed successfully
+verification-command
+```
+
+**Troubleshooting:**
+- Common issue 1: Solution
+- Common issue 2: Solution
+
+### Step 2: [Step Title]
+
+**Objective**: What this step accomplishes
+
+**Commands/Actions:**
+```bash
+# Additional commands
+```
+
+**Expected Output:**
+```
+Expected results
+```
+
+**Validation:**
+```bash
+# Verification commands
+```
+
+**Troubleshooting:**
+- Issue: Solution
+
+## Validation & Testing
+
+### Final Validation Steps
+
+1. **System Check:**
+   ```bash
+   # Commands to verify overall system state
+   ```
+
+2. **Functional Test:**
+   ```bash
+   # Commands to test functionality end-to-end
+   ```
+
+3. **Performance Check** (if applicable):
+   ```bash
+   # Commands to verify performance expectations
+   ```
+
+### Success Criteria
+
+- [ ] Criterion 1: Description of what should be working
+- [ ] Criterion 2: Another measurable outcome
+- [ ] Criterion 3: Final validation point
+
+## Examples
+
+### Example 1: [Scenario Name]
+
+**Context**: Specific use case or scenario
+
+**Implementation:**
+```bash
+# Specific commands for this example
+```
+
+**Result**: What the outcome looks like
+
+### Example 2: [Another Scenario]
+
+**Context**: Different use case
+
+**Implementation:**
+```bash
+# Alternative approach or configuration
+```
+
+**Result**: Expected outcome
+
+## Templates & Code Snippets
+
+### Configuration Template
+
+```yaml
+# Sample configuration file
+key: value
+section:
+  nested_key: nested_value
+```
+
+### Code Template
+
+```ruby
+# Sample code implementation
+class ExampleClass
+  def example_method
+    # Implementation
+  end
+end
+```
+
+## Common Patterns
+
+### Pattern 1: [Pattern Name]
+
+**When to use**: Specific conditions or scenarios
+**How to implement**: Brief implementation guide
+**Example**: Quick code or command example
+
+### Pattern 2: [Another Pattern]
+
+**When to use**: Different scenario
+**How to implement**: Implementation approach
+**Example**: Sample usage
+
+## Troubleshooting
+
+### Error: [Common Error Message]
+
+**Symptoms**: How this error manifests
+**Cause**: Root cause of the issue
+**Solution**: Step-by-step fix
+**Prevention**: How to avoid in the future
+
+### Issue: [Common Problem]
+
+**Symptoms**: Observable behavior
+**Diagnosis**: How to confirm this is the issue
+**Resolution**: Solution steps
+**Verification**: How to confirm it's fixed
+
+## Related Resources
+
+### Documentation Links
+
+- [Official docs link](url)
+- [API reference](url)
+- [Community guide](url)
+
+### Other Cookbooks
+
+- [Related cookbook 1](link)
+- [Related cookbook 2](link)
+
+### External Tools & Resources
+
+- [Tool name](url): Description of how it helps
+- [Resource name](url): What it provides
+
+## Version History
+
+### v1.0 (YYYY-MM-DD)
+- Initial version
+- Core steps documented
+
+### v1.1 (YYYY-MM-DD)
+- Added troubleshooting section
+- Updated validation steps
+
+## Feedback & Improvements
+
+**Known Limitations:**
+- Limitation 1: Description and potential workaround
+- Limitation 2: Impact and mitigation
+
+**Future Enhancements:**
+- Enhancement idea 1
+- Enhancement idea 2
+
+**Contributing:**
+If you find issues or improvements for this cookbook, please:
+1. Document the specific issue or enhancement
+2. Test any proposed changes
+3. Update relevant sections
+4. Increment version number
+
+---
+
+*This cookbook is part of the development workflow documentation. For more cookbooks, see your project cookbooks directory.*

data/handbook/templates/research-comparison.template.md

@@ -0,0 +1,175 @@
+---
+doc-type: template
+title: Research Comparison Matrix
+purpose: Documentation for ace-handbook/handbook/templates/research-comparison.template.md
+ace-docs:
+  last-updated: 2026-01-31
+  last-checked: 2026-03-21
+---
+
+# Research Comparison Matrix
+
+## Overview
+
+| Field | Value |
+|-------|-------|
+| **Task** | [Research task description] |
+| **Date** | [YYYY-MM-DD] |
+| **Research Folder** | [Path to research outputs] |
+| **Agents** | [Agent 1], [Agent 2], [Agent 3] |
+
+## Quality Rating Scale
+
+| Rating | Meaning |
+|--------|---------|
+| 5 | Comprehensive - thorough, well-structured, actionable |
+| 4 | Good - covers main points with useful detail |
+| 3 | Adequate - covers basics, some gaps |
+| 2 | Basic - incomplete or surface-level |
+| 1 | Minimal - significant gaps or issues |
+
+---
+
+## Artifact Inventory
+
+### Reports
+
+| Artifact | Agent A | Agent B | Agent C | Best | Action |
+|----------|---------|---------|---------|------|--------|
+| Main report | [rating] | [rating] | [rating] | [agent] | [merge/use/skip] |
+
+### Guides
+
+| Artifact | Agent A | Agent B | Agent C | Best | Action |
+|----------|---------|---------|---------|------|--------|
+| [guide-name.g.md] | [rating] | — | [rating] | [agent] | [merge/use/skip] |
+
+### Workflows
+
+| Artifact | Agent A | Agent B | Agent C | Best | Action |
+|----------|---------|---------|---------|------|--------|
+| [workflow.wf.md] | [rating] | [rating] | — | [agent] | [merge/use/skip] |
+
+### Templates
+
+| Artifact | Agent A | Agent B | Agent C | Best | Action |
+|----------|---------|---------|---------|------|--------|
+| [template.md] | — | [rating] | [rating] | [agent] | [merge/use/skip] |
+
+### Skills
+
+| Artifact | Agent A | Agent B | Agent C | Best | Action |
+|----------|---------|---------|---------|------|--------|
+| [skill-name] | [rating] | — | — | [agent] | [use/skip] |
+
+---
+
+## Comparison by Type
+
+### Reports Comparison
+
+#### Coverage Analysis
+
+| Topic | Agent A | Agent B | Agent C | Notes |
+|-------|---------|---------|---------|-------|
+| [Topic 1] | ✓ detailed | ✓ brief | — | A most thorough |
+| [Topic 2] | ✓ | ✓ | ✓ | All covered similarly |
+| [Topic 3] | — | ✓ | ✓ | A missed this |
+
+#### Depth Assessment
+
+- **Agent A**: [Assessment of depth, structure, actionability]
+- **Agent B**: [Assessment of depth, structure, actionability]
+- **Agent C**: [Assessment of depth, structure, actionability]
+
+### Guides Comparison
+
+| Guide | Comparison Notes | Selected Source | Rationale |
+|-------|-----------------|-----------------|-----------|
+| [guide-1.g.md] | A: more detailed; C: better examples | A + C examples | Merge best of both |
+
+### Workflows Comparison
+
+| Workflow | Comparison Notes | Selected Source | Rationale |
+|----------|-----------------|-----------------|-----------|
+| [workflow.wf.md] | A: complete phases; B: better templates | A base + B templates | A structure is better |
+
+---
+
+## Conflict Log
+
+### Conflict #1: [Topic]
+
+| Aspect | Description |
+|--------|-------------|
+| **Topic** | [What the disagreement is about] |
+| **Agent A Position** | [What Agent A claims/recommends] |
+| **Agent B Position** | [What Agent B claims/recommends] |
+| **Agent C Position** | [What Agent C claims/recommends, or N/A] |
+| **Research/Verification** | [What was done to verify correct answer] |
+| **Resolution** | [Which position was selected] |
+| **Rationale** | [Why this resolution was chosen] |
+
+### Conflict #2: [Topic]
+
+| Aspect | Description |
+|--------|-------------|
+| **Topic** | [What the disagreement is about] |
+| **Agent A Position** | [Position] |
+| **Agent B Position** | [Position] |
+| **Agent C Position** | [Position] |
+| **Research/Verification** | [Verification steps] |
+| **Resolution** | [Selected position] |
+| **Rationale** | [Reasoning] |
+
+---
+
+## Synthesis Decisions
+
+### Report Synthesis
+
+| Decision | Source(s) | Rationale |
+|----------|-----------|-----------|
+| Use A as base structure | Agent A | Most comprehensive organization |
+| Merge B's examples | Agent B | Clearer practical examples |
+| Add C's edge cases | Agent C | Unique insights on edge cases |
+
+### Artifact Synthesis
+
+| Artifact | Decision | Source(s) | Rationale |
+|----------|----------|-----------|-----------|
+| [guide.g.md] | Merge A + C | A: content, C: examples | Best of both |
+| [workflow.wf.md] | Use A only | Agent A | B version incomplete |
+| [template.md] | Use B only | Agent B | Only complete version |
+| [skill-x] | Skip | None | Not needed for this project |
+
+---
+
+## Gaps Identified
+
+| Gap | Description | Follow-up Needed |
+|-----|-------------|------------------|
+| [Gap 1] | [What was missed by all agents] | [Future task or research] |
+| [Gap 2] | [Another missing area] | [How to address] |
+
+---
+
+## Summary Statistics
+
+| Metric | Value |
+|--------|-------|
+| **Total Artifacts Reviewed** | [N] |
+| **Artifacts Merged** | [N] |
+| **Artifacts Used As-Is** | [N] |
+| **Artifacts Skipped** | [N] |
+| **Conflicts Resolved** | [N] |
+| **Gaps Identified** | [N] |
+
+---
+
+## Attribution
+
+All synthesis decisions credit original sources:
+- Agent A ([model]): [timestamp]-[agent]-report.md
+- Agent B ([model]): [timestamp]-[agent]-report.md
+- Agent C ([model]): [timestamp]-[agent]-report.md