Build an app

Install the guided workflow

npx skills add StanfordSpezi/SpeziVibe --skill '*'

Install all skills so this guide can run the supporting planning skills. See the Getting Started guide for tool-specific options.

Explore this skill in browser chat. Each button opens a new conversation; bring any earlier briefs with you and save the results yourself.

Try in ClaudeTry in ChatGPT

Need to paste the prompt yourself?

Browser prompt for build-an-app

Please act as the SpeziVibe `build-an-app` skill and walk me through it interactively.

STEP 1 — Fetch the skill instructions from this URL and read them carefully:
https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/build-an-app/SKILL.md

STEP 2 — This skill is an orchestrator. It will instruct you to run other skills in sequence. When it tells you to run a sub-skill, you MUST fetch that sub-skill's SKILL.md first and follow ITS instructions before continuing — do not improvise based on the skill name alone.

Sub-skill URLs (fetch each when the orchestrator tells you to run it):
- biodesign-needs-finding: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/biodesign-needs-finding/SKILL.md
- spezi-platform-selection: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/spezi-platform-selection/SKILL.md
- digital-health-ux-planning: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/digital-health-ux-planning/SKILL.md
- digital-health-study-planning: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/digital-health-study-planning/SKILL.md
- health-data-model-planning: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/health-data-model-planning/SKILL.md
- fhir-data-model-design: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/fhir-data-model-design/SKILL.md
- digital-health-compliance-planning: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/digital-health-compliance-planning/SKILL.md
- fasten-ehr-integration: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/fasten-ehr-integration/SKILL.md
- app-build-planner: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/app-build-planner/SKILL.md
- project-wiki: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/project-wiki/SKILL.md

If any sub-skill references additional files (e.g. `references/foo.md`), fetch them from https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/<sub-skill-name>/<relative-path>.

STEP 3 — Walk me through the skill interactively. When a step would normally save a markdown file to a project, show the file content in a code block instead so I can copy it. Don't simulate my answers — wait for me to respond.

If you cannot fetch the skill instructions or their reference files, ask me to paste them before proceeding.
Ask me to paste or attach any existing briefs you need. Do not claim to have read files, run commands, created a project, or tested an integration from this chat. Help me prepare the decisions and instructions, then hand off file and code work to my coding tool.

If your chat can’t open the skill link, open the instructions in a new tab and paste them into the chat.

The main entry point for SpeziVibe. Describe what you want to build and this skill determines which planning skills apply, walks you through each one in sequence, and produces an implementation plan your AI coding agent can build from. See How SpeziVibe Works.

How It Works

1. Asks what you want to build (one open question, at most one follow-up)
2. Identifies which planning skills are relevant based on your description
3. Proposes the order and checks with you before proceeding
4. Runs each skill interactively — you participate in each one
5. Hands off to app-build-planner to produce an implementation plan
6. Helps prepare your project and starts implementation when you’re ready

Skill Selection

The orchestrator picks skills based on signals in your description:

• Mentions a clinical problem or "I don't know where to start" → biodesign-needs-finding
• No existing repo, starting from a Spezi template → spezi-platform-selection (optional — you can build with any framework instead)
• No existing designs → digital-health-ux-planning
• Mentions research, study, or trial → digital-health-study-planning
• Involves health data → health-data-model-planning
• Needs interoperability or EHR integration → fhir-data-model-design
• Mentions HIPAA, patient data, or regulated data → digital-health-compliance-planning
• Patients connecting their own medical records → fasten-ehr-integration
• Wants a persistent project knowledge base → project-wiki
• Always runs → app-build-planner

Skills are skipped if you already have the corresponding planning document.

Example

You:  I want to build a medication tracking app for post-transplant patients

AI:   Based on your description, here's the sequence I'd recommend:
      1. biodesign-needs-finding — define the core problem
      2. digital-health-ux-planning — patient and caregiver workflows
      3. health-data-model-planning — medication schedules, adherence
      4. digital-health-compliance-planning — privacy questions and controls
      5. app-build-planner — implementation plan with milestones
      6. spezi-platform-selection — pick React Native or Apple-native,
         set up the matching template (when you're ready to build)

      All planning briefs land in docs/planning/. spezi-platform-selection
      runs last and brings them into the template project, where your
      coding agent will start building.

      Want to proceed with this order?

You:  Yes, let's go

AI:   Starting with needs-finding. What specific problem are
      post-transplant patients facing with medication adherence?

Output

The selected planning skills save briefs in docs/planning/. The build planner saves docs/implementation-plan.md with milestones, tasks, and dependencies. The guide then helps you prepare the app project and begin building.

What Happens Next

After build-an-app finishes, you have a folder of planning briefs and docs/implementation-plan.md. Inside your project — a generated React Native app, the Apple-native template, or your own repo or scaffold if you chose a different framework — tell your AI coding agent:

Implement Milestone 1 from docs/implementation-plan.md.

The agent uses your planning briefs as context — plus the Spezi template's patterns as scaffolding, if you're using one — to write the code. See How SpeziVibe Works for the full flow.