| name | default-workflow |
|---|---|
| description | Fallback workflow for general implementation and debugging tasks that do not involve creating a new resource. |
This document outlines the structured 5-step lifecycle for formal implementation and debugging tasks in Magic Modules.
- Execute the
repo-syncskill (located in.agents/skills/operations/repo-sync/). This skill handles checking the sync status and prompting for action if needed.
- Gather context on the change or bug. Plan the change (New feature or bug fix) within schema or logic.
- Consult
.agents/knowledge/index.mdfor the topics the change touches and open the relevant sources. - Execute the
triageskill (located in.agents/skills/operations/triage/) to perform this work. - Transfers to Step 3: Approved implementation plan and file paths file.
- Once the first pass at the change is made, execute the code generation using the
generate-providerskill (located in.agents/skills/operations/generate-provider/) to compile machine code in the downstream. - Transfers to Step 4: Compiled provider binary.
- Invoke the specialized
qa-test-runnersubagent using theinvoke_subagenttool to reproduce failures and interpret logs. The subagent evaluates if the test fails/passes and returns a human-readable interpretation of the results. - Transfers to Step 5: Human-readable Markdown report explaining whether the test succeeded or failed, and what discrepancy was found.
- This is a Remediation Planning step (similar to Triage). Take the results from
qa-test-runnerand compare against reference guides or user suggestions. Propose a specific fix code change to the user. - Execute the
fixskill (located in.agents/skills/operations/fix/) to perform this planning.
Repeat steps 2-5 as needed during the session until the primary task is complete. Reset to Step 3 (Generate) after applying an approved fix to compile it!