plan-importer

Plan Importer

Use this skill to turn existing project planning material into a PlanWeave Plan Package.

Command Entry

Resolve the command before writing files:

1. Use a user-provided command if given.
2. Else try global planweave.
3. In the PlanWeave repo, prefer pnpm --filter @planweave-ai/cli planweave.
4. If the repo defines another local script, use that exact entry and show it in the report.

Write examples as <pw> ..., where <pw> is the resolved command.

Use the CLI to resolve the target workspace before writing files:

<pw> init --json
<pw> paths --json
<pw> validate --json

Use the CLI for command discovery, workspace/path resolution, and validation in this workflow. Materialize imports by writing package files directly into the CLI-returned PlanWeave workspace paths.

Workspace

• Run <pw> from the target project root, not from the PlanWeave repo unless PlanWeave itself is the target project.
• Do not create or write ./.planweave inside the target project by hand.
• PlanWeave stores project plans under PLANWEAVE_HOME when set; otherwise defaults to:
  • macOS: ~/.planweave
  • Linux: ~/.planweave
  • Windows: %USERPROFILE%\.planweave
• Read exact workspace paths from <pw> init --json and <pw> paths --json.
• Write only inside CLI-returned PlanWeave workspace paths, such as workspaceRoot, projectGraphPath, and package directories under that workspace.
• For a single-canvas import with an explicit existing target canvas, write only inside that canvas package directory.
• For a single-canvas import without an explicit target canvas, do not overwrite the existing default/current canvas. Create a new formal canvas entry in project-graph.json, allocate a collision-free canvas id, and write the imported package under that canvas package directory.
• For formal multi-canvas plans, write project-graph.json at the returned project/workspace root and write each canvas package only under the package directories named by that project graph.
• Treat CLI-returned project/workspace and package directories as the only writable PlanWeave locations.