Skip to main content

Create an implementation plan

Install this skill
npx skills add StanfordSpezi/SpeziVibe --skill app-build-planner

Or install all skills: npx skills add StanfordSpezi/SpeziVibe --skill '*'. 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.

Need to paste the prompt yourself?
Browser prompt for app-build-planner
Please act as the SpeziVibe `app-build-planner` 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/app-build-planner/SKILL.md

STEP 2 — This skill references additional files. When the instructions tell you to read one, fetch it from these URLs:
- references/react-native-packages.md: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/app-build-planner/references/react-native-packages.md
- references/apple-native-modules.md: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/app-build-planner/references/apple-native-modules.md
- references/milestone-patterns.md: https://raw.githubusercontent.com/StanfordSpezi/SpeziVibe/main/skills/app-build-planner/references/milestone-patterns.md

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.

Reads planning documents from the other skills and produces a milestone-based implementation plan. Does not generate code — your AI coding agent uses the plan to write the code. See How SpeziVibe Works.

Inputs​

Reads whichever of these exist (works with whatever's available):

  • docs/planning/need-statement.md
  • docs/planning/ux-brief.md
  • docs/planning/study-brief.md
  • docs/planning/data-model-brief.md
  • docs/planning/fhir-data-model.md
  • docs/planning/compliance-brief.md
  • docs/planning/ehr-connection-brief.md

Also asks for your platform choice (React Native, Apple-native, or another framework you're using) and backend choice (Firebase, Medplum, or other). If you haven't decided the platform yet — you'll pick it with spezi-platform-selection afterwards — the plan is written to work for either and narrowed once you choose. If you're not using a Spezi template, the plan still works — see How SpeziVibe Works.

Output​

Produces docs/implementation-plan.md containing:

  • Context table (app name, need statement, platform, backend)
  • Planning inputs summary with gaps noted
  • Feature list with priorities and package mappings
  • Milestone sequence (typically 8-12 milestones) each with:
    • Goal, dependencies, tasks, platform notes, verification criteria
  • Data model and compliance integration tables
  • Open questions

Example​

AI:   Which platform are you on — React Native, Apple-native, or
something else? And which backend — Firebase, Medplum, or
something else?

You: Apple-native with Firebase.

AI: I've read your planning docs. Here's a proposed milestone
sequence:

Milestone 1: Foundation
— Configure Firebase project and authentication
— Set up Firestore security rules
— Verify build and test pipeline
Verification: User can sign in and see empty home screen

Milestone 2: Onboarding
— Implement consent flow using SpeziOnboarding
— Add profile setup (name, date of birth)
— Request HealthKit permissions
Verification: New user completes onboarding and lands on home

Milestone 3: Medication Tracking
— Build medication list view
— Implement daily check-in flow
— Store adherence data in Firestore
Verification: Patient can log medications and see history

...8 more milestones...

Ready to start building Milestone 1?

Limitations​

  • Does not generate application code — only a plan document
  • Features without matching packages are flagged as "custom implementation" with effort estimates
  • Milestones are capped at 5-7 tasks; larger ones are split
  • Flags all gaps from missing planning inputs

Next Step​

Review docs/implementation-plan.md, resolve any open platform decisions, and make sure it and your briefs are inside the app project. If you need help setting up that project, resume with build-an-app. Then ask your coding agent to implement the first agreed milestone and verify its result before continuing.