gsd-import

Import external plans into GSD with conflict detection against project decisions.

Updated Apr 22, 2025
One-click install
npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-import-mcampbellr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-import
Source: https://github.com/mcampbellr/.dotfiles/tree/main/claude/.claude/skills/gsd-import
Command: npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-import-mcampbellr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of importing external plans into the GSD planning system, ensuring that project decisions are respected and conflicts are detected before writing anything.

Core Features & Use Cases

  • Conflict Detection: Checks external plans against project decisions in PROJECT.md to avoid conflicting updates.
  • External Plan Import: Supports importing from external file paths or GSD-2 project directories.
  • Use Case: When you have a new project plan in a different format and want to integrate it into your GSD planning system, this Skill will handle the import and ensure that there are no conflicts with existing plans.

Quick Start

Use the gsd-import skill to import an external plan from 'external-plan.json'.

Frequently Asked Questions about gsd-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import external plans into the GSD planning system?

To import external plans into the GSD planning system, use the gsd-import skill to ingest external file paths or migrate GSD-2 project directories directly. It ensures compatibility and checks for conflicts before writing data.

How does conflict detection work when importing project plans?

Conflict detection works by checking external plans against existing project decisions defined in PROJECT.md. This validation process prevents conflicting updates and maintains planning integrity before any import is executed.

Can I migrate project plans from GSD-2 to GSD v1 format?

Yes, you can migrate project plans from GSD-2 to GSD v1 formats. The import functionality supports direct migration from GSD-2 project directories to ensure formatting compatibility within the planning system.

Do I need a PROJECT.md file to import external plans?

Yes, a PROJECT.md file is required to import external plans. It contains the existing project decisions used as the baseline for conflict detection, ensuring the new external plan respects current project constraints.

What is the best way to automate plan ingestion and avoid conflicting updates?

The best way to automate plan ingestion and avoid conflicting updates is using the gsd-import skill, which validates external plans against PROJECT.md decisions before execution to guarantee workflow integrity.

What are the limitations of importing external plans into GSD?

The primary limitation is that external plans must not conflict with decisions in PROJECT.md; otherwise, the import is blocked to preserve project planning integrity. It also strictly requires either a file path or GSD-2 directory format.