| name | tangram-define |
| description | Tangram command /tangram:define. Start the Preconstruct phase by defining the core concept of the app, or update an existing definition. |
Codex adaptation of .codex/workflows/tangram/commands/tangram/preconstruct/define.toml.
Use this skill when the user asks for /tangram:define, $tangram-define, 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 define command.
Your goal is to guide the user in generating or updating tangram/overview.md, which serves as the general, high-level summary of the application.
Input: Triggered by /tangram:define. Optionally, the user may include an idea or an update request.
Steps
-
Check State & Analyze
First, check if tangram/overview.md already exists and read its contents.
- If it DOES NOT exist (Creation Mode): Review the user's input. If the name or the idea is omitted/vague, you MUST ask: "What is the name of the app/project and the general idea of what you want to build?"
- If it DOES exist (Update Mode): Compare the user's new input against the current overview.md. Act as a strategic partner. Acknowledge the shift and ask for their reasoning to ensure the app's vision stays coherent.
Example: "I see you want to add/remove [Feature]. Our original overview focused on [Original Focus]. What is driving this change? Should we adjust the Target Audience or Vision to reflect this pivot?" Wait for their response before drafting.
-
Suggest the Draft
Once you have the necessary context, generate a draft for tangram/overview.md using the template below and present it to the user.
Do not write the file yet. Just show the suggested content.
-
Wait for Approval
Ask: "Does this capture the core idea, or would you like to make further adjustments before we finalize it?"
Pause and wait for the user's response.
-
Summarize and Write
Once the user approves (or after applying their requested adjustments), write the final content to tangram/overview.md.
Announce that the file has been successfully created or updated.
Output On Success
Project Definition Complete
File Created: tangram/overview.md
Vision: [App Name] core concept established.
Next Action: Run /tangram:constitution to establish the non-negotiable laws and principles of your project.
Draft Template for tangram/overview.md
[App Name / Working Title]
Core Concept
[1-2 paragraphs explaining what the app is and its primary value proposition. Keep it simple and visionary.]
Target Audience
[A brief description of who this application is built for.]
High-Level Vision
[A short summary of what the app will feel like from a user's perspective, focusing on the main problem it solves.]
Guardrails
- Identity First: Never proceed with the draft until a name or working title is established.
- Strict Loop: Suggest -> Approve -> Summarize -> Write.
- Consultative Tone: Ensure any updates to the vision make logical sense before overwriting the file.
