Flowai Adapt

Instructions

<step_by_step>

1. Detect IDE config directories

   • Scan project root for .claude/, .cursor/, .opencode/.
   • Use all detected dirs for subsequent operations.
   • If none found, inform user and stop.

2. Parse arguments

   • No args -> adapt ALL types (skills, agents, assets, hooks).
   • --skills -> only skills.
   • --agents -> only agents.
   • --assets -> only AGENTS.md artifacts.
   • --hooks -> only hooks.
   • Positional name arg -> filter to that single resource within selected type(s).

3. Adapt skills (when applicable)

   • List all flowai-* directories in {ide}/skills/.
   • Filter by name argument if provided.
   • Launch one flowai-skill-adapter subagent per skill — all in parallel.
   • Each subagent receives the skill name and path. It autonomously reads:
     • Working tree SKILL.md (current version)
     • git show HEAD:<path>/SKILL.md (previous adapted version, if exists)
     • AGENTS.md for project context
   • Wait for all subagents to complete.
   • For each adapted skill, show the diff: git diff HEAD -- <skill-path>.
   • Ask user for confirmation per skill.
   • Revert rejected adaptations: git checkout HEAD -- <skill-path>.

4. Adapt agents (when applicable)

   • List all flowai-* files in {ide}/agents/.
   • Filter by name argument if provided.
   • Launch one flowai-agent-adapter subagent per agent — all in parallel.
   • Each subagent receives the agent name and path. It autonomously reads:
     • Working tree agent .md (current version)
     • git show HEAD:<path> (previous adapted version, if exists)
     • AGENTS.md for project context
   • Wait for all subagents to complete.
   • For each adapted agent, show the diff: git diff HEAD -- <agent-path>.
   • Ask user for confirmation per agent.
   • Revert rejected adaptations: git checkout HEAD -- <agent-path>.

5. Verify AGENTS.md artifacts (when applicable)

   • Read pack.yaml from installed packs (via .flowai.yaml) to get the assets: mapping (template name -> artifact path).
   • If pack.yaml is unavailable, use default mapping:
     • AGENTS.template.md -> AGENTS.md
   • If the project still has documents/AGENTS.md or scripts/AGENTS.md, defer to flowai-update or flowai-init to run the legacy-collapse procedure — do NOT handle collapse here.
   • For each template -> artifact pair: a. Read the framework template from {ide}/assets/. b. Read the project artifact. c. Compare using git diff --no-index -- <template> <artifact>. d. Ignore {{PLACEHOLDER}} sections in the diff. e. Focus on framework-originated sections (rules, TDD flow, doc formats, planning rules). f. If framework sections are outdated -> propose update with before/after.
   • Ask confirmation per artifact.

6. Adapt hooks (when applicable)

   • List hook scripts in {ide}/scripts/ (installed by flowai).
   • For each: read the script, check if it contains stack-specific commands (e.g., deno lint, npm test).
   • If stack-agnostic (like current validation hooks) -> skip.
   • If stack-specific commands detected -> adapt via direct agent rewrite (replace commands with project-specific equivalents from AGENTS.md).
   • Show diff, ask confirmation.

7. Summary

   • Report totals: X skills adapted, Y agents adapted, Z artifacts verified, W hooks adapted.
   • Note any skipped or rejected resources.

</step_by_step>

Verification