ace-assign 0.37.0

data/.ace-defaults/assign/presets/fix-bug.yml

@@ -0,0 +1,65 @@
+# Bug fix workflow: onboard → fix → verify → PR → review
+# Usage: /as-assign-prepare fix-bug --taskref 123
+
+name: fix-bug
+description: Fix an issue, verify tests, and create a reviewed PR
+
+parameters:
+  taskref:
+    required: true
+    description: Task reference for the bug fix (e.g., 123 or 256.01)
+  review_cycles:
+    required: false
+    default: 1
+    description: Number of review cycles to perform
+
+steps:
+  - name: onboard
+    skill: as-onboard
+    instructions:
+      - Onboard yourself to the codebase.
+      - Load context and understand the project structure.
+
+  - name: work-on-task
+    skill: as-task-work
+    instructions:
+      - "First: onboard yourself using /as-onboard skill to load project context."
+      - "Fix the issue described in task {{taskref}}."
+      - Follow the bug fix workflow: analyze → reproduce → fix → test.
+
+  - name: mark-task-done
+    instructions:
+      - "Mark task {{taskref}} as done."
+      - "Run: ace-task update {{taskref}} --set status=done --move-to archive"
+      - "Commit the archive file moves: `ace-git-commit .ace-tasks/ -i 'archive completed task'`"
+
+  - name: verify-test-suite
+    skill: as-test-verify-suite
+    instructions:
+      - Run the test suite to verify the fix doesn't break anything.
+      - Ensure all tests pass.
+
+  - name: create-pr
+    skill: as-github-pr-create
+    instructions:
+      - Create a pull request for the bug fix.
+      - Include reference to the bug/task in the PR description.
+
+  - name: review-cycle-1
+    skill: as-review-pr
+    context: fork
+    instructions:
+      - "First: onboard yourself using /as-onboard skill to load project context."
+      - Review the bug fix code.
+      - Focus on correctness and edge cases.
+
+  - name: apply-feedback-1
+    skill: as-review-apply-feedback
+    instructions:
+      - Apply feedback from the review.
+      - Commit changes with descriptive messages.
+
+customization_hints:
+  - "Add fix-tests after verify-test-suite if failures found"
+  - "Add security-audit for security-related fixes"
+  - "Increase review cycles for critical fixes"

data/.ace-defaults/assign/presets/quick-implement.yml

@@ -0,0 +1,41 @@
+# Quick implementation workflow: onboard → work → commit
+# Usage: /as-assign-prepare quick-implement --taskref 123
+
+name: quick-implement
+description: Implement a task with commit, no PR or review cycles
+
+parameters:
+  taskref:
+    required: true
+    description: Task reference (e.g., 123 or 256.01)
+
+steps:
+  - name: onboard
+    skill: as-onboard
+    instructions:
+      - Onboard yourself to the codebase.
+      - Load context and understand the project structure.
+
+  - name: work-on-task
+    skill: as-task-work
+    instructions:
+      - "First: onboard yourself using /as-onboard skill to load project context."
+      - "Work on task {{taskref}}."
+      - Implement the required changes following project conventions.
+      - Keep changes focused and atomic.
+
+  - name: mark-task-done
+    instructions:
+      - "Mark task {{taskref}} as done."
+      - "Run: ace-task update {{taskref}} --set status=done --move-to archive"
+
+  - name: commit
+    skill: as-git-commit
+    instructions:
+      - Commit the changes.
+      - Use a descriptive commit message following project conventions.
+
+customization_hints:
+  - "Add verify-test-suite before commit for complex changes"
+  - "Add lint after work-on-task for style enforcement"
+  - "Skip onboard if already onboarded"

data/.ace-defaults/assign/presets/release-only.yml

@@ -0,0 +1,35 @@
+# Release-only workflow: onboard → release → commit
+# Usage: /as-assign-prepare release-only --version_type patch
+
+name: release-only
+description: Version bump and changelog update without code changes
+
+parameters:
+  version_type:
+    required: false
+    default: "patch"
+    description: "Version bump type (major, minor, or patch)"
+
+steps:
+  - name: onboard
+    skill: as-onboard
+    instructions:
+      - Onboard yourself to the codebase.
+      - This step is optional if already in context.
+
+  - name: release
+    instructions:
+      - Run /as-release to release all modified packages.
+      - "Auto-detect modified packages, apply a {{version_type}} release, and update both package and root CHANGELOGs."
+      - Follow semantic versioning conventions.
+      - Update both gem version files and CHANGELOGs.
+
+  - name: commit
+    skill: as-git-commit
+    instructions:
+      - Commit the version bump and changelog changes.
+      - Use conventional commit format.
+
+customization_hints:
+  - "Add push-to-remote step for immediate push"
+  - "Skip onboard if already onboarded"

data/.ace-defaults/assign/presets/work-on-docs.yml

@@ -0,0 +1,41 @@
+# Documentation workflow: onboard → research → write → commit
+# Usage: /as-assign-prepare work-on-docs --scope ace-review
+
+name: work-on-docs
+description: Create or update documentation with research and commit
+
+parameters:
+  scope:
+    required: true
+    description: "Package, directory, or topic to document"
+
+steps:
+  - name: onboard
+    skill: as-onboard
+    instructions:
+      - Onboard yourself to the codebase.
+      - Load context for the documentation target area.
+
+  - name: research
+    skill: as-search-research
+    context: fork
+    instructions:
+      - "First: onboard yourself using /as-onboard skill to load project context."
+      - "Research documentation gaps for {{scope}}."
+      - Identify outdated, missing, or incorrect documentation.
+      - Review existing docs to understand the documentation style.
+
+  - name: work-on-task
+    skill: as-task-work
+    instructions:
+      - "Create or update documentation for {{scope}}."
+      - Focus on clarity, accuracy, and completeness.
+      - Follow project documentation conventions.
+      - Use markdown formatting appropriately.
+
+  - name: commit
+    skill: as-git-commit
+    instructions:
+      - Commit the documentation changes.
+      - Use a descriptive commit message.
+      - Follow conventional commit format if applicable.

data/.ace-defaults/assign/presets/work-on-task.yml

@@ -0,0 +1,179 @@
+# Unified task workflow: single or multi-task implement → release → PR → review cycles → reorganize → push
+# Usage: /as-assign-prepare work-on-task --taskref 123
+#        /as-assign-prepare work-on-task --taskrefs 148,149,150
+#        /as-assign-prepare work-on-task --taskrefs 148-152
+#        /as-assign-prepare work-on-task --taskrefs "240.*"
+
+name: work-on-task
+description: Work on one or more tasks with PR, review cycles, release, and clean history
+
+parameters:
+  taskrefs:
+    required: true
+    type: array
+    description: Task references (comma-separated, range, or pattern)
+
+steps:
+  - name: onboard
+    number: "000"
+    workflow: wfi://onboard
+    instructions:
+      - "Load project context for the task batch: {{taskrefs}}."
+
+  - name: verify-test-suite
+    number: "012"
+    workflow: wfi://test/verify-suite
+    instructions:
+      - "Verify test coverage and performance across batch tasks: {{taskrefs}}."
+      - "Focus on packages modified by this batch before any broader regression checks required by the workflow."
+      - "If the batch is documentation-only or otherwise does not affect runnable code, mark this step skipped with a clear reason."
+
+  - name: verify-e2e
+    number: "015"
+    context: fork
+    instructions:
+      - "Run E2E tests for packages modified across batch tasks: {{taskrefs}}."
+      - "Detect modified packages from the current diff: `git diff origin/main --name-only | grep '^ace-' | cut -d/ -f1 | sort -u`."
+      - "Run `ace-test-e2e <package>` for each modified package that has test/e2e/ scenarios."
+      - "If more than 5 packages were modified with cross-dependencies, run the full suite: `ace-test-e2e-suite`."
+      - "If any scenarios fail, use /as-e2e-fix to diagnose and fix each failing scenario."
+      - "After fixing, rerun the failing scenarios to confirm they pass."
+      - "Repeat fix→rerun cycle up to 3 times if new failures appear."
+      - "Final gate: all previously-failing scenarios must pass before completing this step."
+      - "Skip only when no modified package has test/e2e/ scenarios."
+
+  - name: release-minor
+    number: "020"
+    instructions:
+      - Release all modified packages touched by this batch.
+      - Auto-detect modified packages from the current diff, bump version (minor or patch, usually minor), and update both package and root CHANGELOGs.
+      - This is the initial release for new functionality.
+      - Follow semantic versioning conventions.
+
+  - name: update-docs
+    number: "025"
+    workflow: wfi://docs/update
+    instructions:
+      - "Update docs for public contract changes introduced across batch tasks: {{taskrefs}}."
+      - "Limit updates to packages whose CLI commands, flags, outputs, or public APIs changed across the batch."
+      - "Validate updated docs before completing the step."
+      - "Skip if the batch introduced no public-facing contract change."
+
+  - name: create-pr
+    number: "030"
+    workflow: wfi://github/pr/create
+    instructions:
+      - "Create a pull request summarizing batch tasks: {{taskrefs}}."
+      - "Capture the PR number for the downstream review and PR-update steps."
+
+  - name: review-valid-1
+    number: "040"
+    context: fork
+    sub_steps: [review-pr, apply-feedback, release]
+    instructions:
+      - Execute the valid review cycle via child steps.
+      - "Child review-pr: use preset code-valid."
+      - "Focus: correctness — bugs, logic errors, missing functionality, broken contracts."
+      - "Child apply-feedback: apply medium+ priority review findings and commit."
+      - "Child release: follow `ace-bundle wfi://release/publish` to publish patch-level updates for modified packages touched by valid-cycle fixes and update both package and root CHANGELOGs."
+
+  - name: review-fit-1
+    number: "070"
+    context: fork
+    sub_steps: [review-pr, apply-feedback, release]
+    instructions:
+      - Execute the fit review cycle via child steps.
+      - "Child review-pr: use preset code-fit."
+      - "Focus: quality — performance, architecture, standards, test coverage."
+      - "Child apply-feedback: apply fit-cycle findings and commit."
+      - "Child release: follow `ace-bundle wfi://release/publish` to publish patch-level updates for modified packages touched by fit-cycle fixes and update both package and root CHANGELOGs."
+
+  - name: review-shine-1
+    number: "100"
+    context: fork
+    sub_steps: [review-pr, apply-feedback, release]
+    instructions:
+      - Execute the shine review cycle via child steps.
+      - "Child review-pr: use preset code-shine."
+      - "Focus: polish — simplification, naming, documentation (non-blocking suggestions)."
+      - "Child apply-feedback: apply worthwhile shine-cycle findings and commit."
+      - "Child release: follow `ace-bundle wfi://release/publish` to publish patch-level updates for modified packages touched by shine-cycle fixes and update both package and root CHANGELOGs."
+
+  - name: reorganize-commits
+    number: "130"
+    workflow: wfi://git/reorganize-commits
+    instructions:
+      - "Reorganize commits for the batch work on: {{taskrefs}}."
+      - "Group commits by concern where possible, such as structure, implementation, tests, docs, and release updates."
+
+  - name: push-to-remote
+    number: "140"
+    instructions:
+      - Push all changes to the remote repository.
+      - "Run: git push --force-with-lease origin HEAD"
+      - Force-with-lease needed because reorganize-commits rewrites history.
+
+  - name: update-pr-desc
+    number: "150"
+    context: fork
+    workflow: wfi://github/pr/update
+    instructions:
+      - "Update the PR description with the final batch summary for: {{taskrefs}}."
+      - "CRITICAL: The File Changes section must contain the complete, untruncated grouped-stats output from `ace-git diff`. Paste it verbatim — never summarize or abbreviate."
+      - "Include final release/version information and the key completed components when applicable."
+      - "Make sure the PR description reflects the post-review final state."
+
+  - name: mark-tasks-done
+    number: "155"
+    workflow: wfi://task/update
+    instructions:
+      - "Mark each top-level task in {{taskrefs}} as done and archive it."
+      - |
+        Run this loop for each task in the batch:
+        - Parse and normalize:
+          - `TASKREFS="{{taskrefs}}"`
+          - `IFS=',' read -ra refs <<< "${TASKREFS// /}"`
+        - For each `ref`:
+          - `ace-task update "$ref" --set status=done --move-to archive`
+      - |
+        After all tasks are archived, commit the file moves:
+        ```bash
+        ace-git-commit .ace-tasks/ -i "archive completed tasks"
+        ```
+
+  - name: create-retro
+    number: "160"
+    skill: as-retro-create
+    instructions:
+      - "Create a retrospective for the batch work on: {{taskrefs}}."
+      - "Capture what went well, what could improve, and action items across the batch."
+      - "Focus on process learnings, not just task outcomes."
+
+expansion:
+  batch-parent:
+    name: batch-tasks
+    number: "010"
+    instructions: |
+      Batch container for multiple task implementations.
+      This step auto-completes when all child tasks are done.
+
+      Tasks to implement: {{taskrefs}}
+
+  foreach: taskrefs
+  child-template:
+    name: "work-on-{{item}}"
+    parent: "010"
+    context: fork
+    workflow: wfi://task/work
+    taskref: "{{item}}"
+    instructions: |
+      Use existing base and task context loaded by the batch workflow.
+      Implement task {{item}}.
+
+      **Prior sibling context** (for sequential batches):
+      If this task has dependencies on earlier tasks in the batch, load their context before planning:
+      1. Read completed sibling task specs: `ace-bundle task://<dependency-ref>` for each ref in the task's `dependencies` field
+      2. Read completed sibling reports from `.ace-local/assign/<assignment-id>/reports/<sibling-step>.*` — especially `work-on-task` and `plan-task` reports
+      3. Use this context during planning to identify existing implementations to refactor rather than reimplement
+
+      When complete, mark the task as done: run `ace-task update {{item}} --set status=done --move-to archive`

data/.ace-defaults/nav/protocols/skill-sources/ace-assign.yml

@@ -0,0 +1,19 @@
+---
+# Skill Sources Protocol Configuration for ace-assign gem
+# This enables canonical skill discovery from the installed ace-assign gem
+
+name: ace-assign
+type: gem
+description: Canonical skills from ace-assign gem
+priority: 10
+
+# Configuration for skill discovery within the gem
+config:
+  # Relative path within the gem
+  relative_path: handbook/skills
+
+  # Pattern for finding canonical skill files
+  pattern: "*/SKILL.md"
+
+  # Enable discovery
+  enabled: true

data/.ace-defaults/nav/protocols/wfi-sources/ace-assign.yml

@@ -0,0 +1,19 @@
+---
+# WFI Sources Protocol Configuration for ace-assign gem
+# This enables workflow discovery from the installed ace-assign gem
+
+name: ace-assign
+type: gem
+description: Assignment workflow instructions from ace-assign gem
+priority: 10
+
+# Configuration for workflow discovery within the gem
+config:
+  # Relative path within the gem (default: handbook/workflow-instructions)
+  relative_path: handbook/workflow-instructions
+
+  # Pattern for finding workflow files (default: *.wf.md)
+  pattern: "*.wf.md"
+
+  # Enable discovery
+  enabled: true