Skip to content

JPeetz/agent-skills / skills/development/app-scaffolding

app-scaffolding

Verified

Use this skill when the user has decided to build a mobile app and needs a complete production blueprint — not brainstorming, not feature ideas, but an actual build brief. Covers both iOS and Android with exact tech stack, screen specs, monetization, and a 30-day sprint plan. Use when the user says things like "Scaffold this app" "Give me a build plan" "Write the PRD" "How do I build this?" "Create a technical spec" "Blueprint this idea" even if they don't mention "scaffolding" or the number of sections.

FileKindSize
CHANGELOG.mdmarkdown372 B
SKILL.mdskill md5.0 KB
evals/evals.jsonconfig2.6 KB
references/corrections.mdmarkdown1.6 KB

references/corrections.md

View on GitHub
# Scaffolding Corrections Log

_Real-world failures that shaped this skill. AgentForge test runs 2026-05-24._

## Correction 1: Scaffolded a Non-Mobile App (Forge)

**Problem:** Phase 6 generated a full scaffold for Forge before the mobile-only scope gate was added. The scaffold was technically correct but for the wrong platform.

**Fix applied:** Scaffolding now only triggers if scrutiny verdict is BUILD AND the candidate passes the Mobile-First Fit scoring dimension (6/10 minimum). CLI/SaaS scaffolds waste production time.

## Correction 2: Tool Honesty — Video & Music Claims

**Problem:** Initial tool section claimed Runway Gen-4.5 and Luma Dream Machine as primary/secondary video tools. Joerg: "Sorry, how can you create videos and music?" Neither API key existed.

**Fix applied:** Verified what's actually available:
- Images: fal.ai FLUX (✅ tested)
- Video: video_generate via openrouter/google/veo-3.1-fast (✅ available, 4-8s)
- Video: runway/gen4.5 (🔑 provider exists, needs RUNWAY_API_KEY)
- Music: music_generate via openrouter/google/lyria-3-pro-preview (✅ available, 180s)
- Removed all aspirational tool claims. Only verified tools listed.

## Correction 3: Local AI — Added After External Input

**Problem:** Original scaffold used Firebase/CloudKit for all AI. Joerg linked ai-agents-from-scratch repo.

**Fix applied:** Added Section 8.4 — Local-First AI Agent Architecture using llama.cpp/MediaPipe/MLX Swift with Phi-4-mini on-device. Mapping repo examples (intro/translation/react-agent/coding/scaling) directly onto app features. Competitive moat: zero cloud inference costs, offline capability, privacy nutrition label advantage.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall