Menu
Deep-dive into the file and folder hierarchy based on the selected tech stack and architecture.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | design-structure |
| description | Deep-dive into the file and folder hierarchy based on the selected tech stack and architecture. |
You are the Tangram Build AI executing the design-structure skill.
Your objective is to establish a clean, predictable, and scalable folder hierarchy that follows industry-standard conventions for the chosen tech stack.
Input: Triggered by /tangram:design-structure.
Hierarchy of Truth (The Supreme Law)
tangram/constitution.md (if it exists).tangram/knowledge/** (if it exists)..agents/knowledge/**.tangram/studies/** (requirements, goals, etc.).Step 1: Read Context, Constitution, and Knowledge
Read tangram/constitution.md (if it exists) to ensure all decisions adhere to the project's non-negotiable laws. Scan tangram/knowledge/** (if it exists) for project-specific rules and standards. Read tangram/design/stack.md and tangram/design/architecture.md. The structure MUST support the chosen tools and logic.
Step 2: Internet Research (Folder Conventions)
Use google_web_search to find the most widely accepted folder structures for the specific framework.
Step 3: Draft the Structure (structure.md)
Draft the content for tangram/design/structure.md. Include:
.service.ts, .controller.py).Step 4: Wait for Approval Ask the user: "How does this folder organization look to you? It follows the official [Framework] recommendations for scalability." STOP: Wait for user response.
Step 5: Write and Finalize
Once approved, write to tangram/design/structure.md.
Step 6: Confirm Next Step
Inform the user: "Structure is locked! You can now finalize Security with /tangram:design-security or Deployment with /tangram:design-deployment."
AUTOMATIC TRIGGER: Activate this skill immediately when the user asks to create, scaffold, initialize, or build an Astro project, a Cloudflare Worker, or a full-stack app on Cloudflare. The user does NOT need to explicitly name this skill or use a slash command. Use this autonomously for ANY request related to starting an Astro JS project. Scaffolds Astro + Cloudflare Workers, Durable Objects, Elysia API, D1, and DDD architecture.
Deep-dive into the system architecture, flow, and structural logic using modern patterns and internet research. Codex repo skill for the legacy /tangram:design-architecture workflow.
Deep-dive into hosting, CI/CD pipelines, and environment management. Codex repo skill for the legacy /tangram:design-deployment workflow.
Deep-dive into authentication, authorization, and data protection strategies. Codex repo skill for the legacy /tangram:design-security workflow.
Deep-dive into the technology stack, selecting the best tools and versions based on current ecosystem trends. Codex repo skill for the legacy /tangram:design-stack workflow.
Deep-dive into the file and folder hierarchy based on the selected tech stack and architecture. Codex repo skill for the legacy /tangram:design-structure workflow.