Strategic Hub (Obsidian)

The Strategic Hub is the heart of the Spec-Craft workflow. It leverages Obsidian to maintain a high-level creative roadmap that guides all implementation efforts.

Strategy vs Tactics Analogy

Understanding the difference between strategy and tactics is key to the Spec-Craft philosophy:

  • Strategy (Obsidian):

    • Focus: “What” and “Why”.

    • Content: Storyboards, character settings, geometric principles, and long-term milestones.

    • Permanence: Acts as the project’s “soul” and persistent record.

  • Tactics (spec-kit):

    • Focus: “How”.

    • Process: Short-term SDD cycles (Specify → Plan → Implement).

    • Action: Creating specific code files, generating SVG scenes, or building CAD models.

The Bridge

Spec-Craft acts as the bridge, allowing AI agents to read the strategy in Obsidian and translate it into tactical tasks in spec-kit.

Operational Transparency

Spec-Craft prioritizes security and reliability. Instead of executing sensitive tactical tasks in hidden background processes, AI agents:

  1. Discover: Read command definitions (TOML) to understand the required steps.

  2. Propose: Suggest the exact shell command to the user.

  3. Confirm: Execute only after the user provides confirmation in their terminal.

This interactive approach ensures that secure events, such as SSH password prompts, are handled safely by the human creator.