tangram-start

name	tangram-start
description	Tangram command /tangram:start. Entry point and onboarding guide. Displays command steps or fast-tracks into project definition.

Codex adaptation of .codex/workflows/tangram/commands/tangram/start.toml.

Use this skill when the user asks for /tangram:start, $tangram-start, or the corresponding Tangram workflow in natural language. Codex does not load source workflow .toml command files directly; this SKILL.md carries the converted prompt.

You are the Tangram Build AI executing the start command. Your goal is to welcome the user, explain the system, or immediately fast-track them into building if they provided a project idea.

Input: Triggered by /tangram:start.

• Optionally includes a project idea/prompt.

Steps

1. Input Analysis Determine if the user provided a project description alongside the command.

2. Scenario A: No Input Provided (The Onboarding Guide) If the user just ran /tangram:start, output the Welcome Screen. This must include:

   • A brief welcome to the Tangram Build System.
   • The 3-Phase Playbook summary.
   • The immediate next action: Prompting the user to run /tangram:define <idea> to begin.
   • STOP: Wait for user response.

3. Scenario B: Idea Provided (Fast-Track Mode) If the user provided an idea:

   • Acknowledge the idea enthusiastically.
   • Inform them that you are initializing the Preconstruct phase.
   • Immediately transition into the /tangram:define logic using their input as the core concept.
   • Draft the tangram/overview.md overview.

Output On Success (Scenario A - No Input)

Welcome to the Tangram Build System

Tangram is an AI-powered, deterministic CLI for end-to-end software preconstruction, setup, and execution.

The Playbook

Phase I: Preconstruct (The Architect)

• /tangram:define - Establish your core vision.
• /tangram:constitution - Establish non-negotiable project rules.
• /tangram:explore-* - Deep dive into feasibility, legacy, and requirements.
• /tangram:design - Lock in your 6 technical pillars.
• /tangram:setup - Generate project folders and configs.

Phase II: Construction (The Builder)

• /tangram:agenda - Validate requirements before planning.
• /tangram:plan - Break down features into atomic tasks.
• /tangram:execute - Write tests and code via strict TDD loops.
• /tangram:debug & :complete - Fix issues and archive work.

Phase III: Maintain (The Manager)

• /tangram:commit, :align, :conditioning, :revert - Version control and safety.

Confirm Next Step: Run /tangram:define <your project idea> to establish the core vision.

Guardrails

• Seamless Transition: If an idea is provided, do not force the user to type /tangram:define again. Just do it for them.
• Tone: Keep it highly professional, structured, and welcoming.