Skip to content

MustafaKucukcoskun/Refine-agent-kit / .agents/skills/app-builder

app-builder

Verified

Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.

App Builder - Application Building Orchestrator

Analyzes user's requests, determines tech stack, plans structure, and coordinates agents.

🎯 Selective Reading Rule

Read ONLY files relevant to the request! Check the content map, find what you need.

FileDescriptionWhen to Read
project-detection.mdKeyword matrix, project type detectionStarting new project
tech-stack.md2026 default stack, alternativesChoosing technologies
agent-coordination.mdAgent pipeline, execution orderCoordinating multi-agent work
scaffolding.mdDirectory structure, core filesCreating project structure
feature-building.mdFeature analysis, error handlingAdding features to existing project
blueprints/SKILL.mdProject blueprintsScaffolding new project

πŸ“¦ Blueprints (13)

These files are prompt-time reference blueprints, not executable starter repos. Read only the matching blueprint, then scaffold the project from that guidance.

BlueprintTech StackWhen to Use
nextjs-fullstackNext.js + PrismaFull-stack web app
nextjs-saasNext.js + StripeSaaS product
nextjs-staticNext.js + FramerLanding page
nuxt-appNuxt 4 + PiniaVue full-stack app
express-apiExpress + JWTREST API
python-fastapiFastAPIPython API
react-native-appExpo + ZustandMobile app
flutter-appFlutter + RiverpodCross-platform mobile
electron-desktopElectron + ReactDesktop app
chrome-extensionChrome MV3Browser extension
cli-toolNode.js + CommanderCLI app
monorepo-turborepoTurborepo + pnpmMonorepo
astro-staticAstro + MDXBlog / Docs

πŸ”— Related Agents

AgentRole
project-plannerTask breakdown, dependency graph
frontend-specialistUI components, pages
backend-specialistAPI, business logic
database-architectSchema, migrations
devops-engineerDeployment, preview

Usage Example

User: "Make an Instagram clone with photo sharing and likes"

App Builder Process:
1. Project type: Social Media App
2. Tech stack: Next.js + Prisma + Cloudinary + Clerk
3. Create plan:
   β”œβ”€ Database schema (users, posts, likes, follows)
   β”œβ”€ API routes (12 endpoints)
   β”œβ”€ Pages (feed, profile, upload)
   └─ Components (PostCard, Feed, LikeButton)
4. Coordinate agents
5. Report progress
6. Start preview

Quality Upgrade Protocol (v1)

Use this protocol for every non-trivial build request.

1. Outcome-First Framing

Define success as product outcomes, not only code completion.

QuestionWhy It Matters
What business/user outcome must improve?Prevents feature-for-feature's-sake building
What does failure look like?Creates guardrails for trade-offs
What is the quality bar for v1?Aligns scope and ambition

2. Dynamic Constraint Envelope

Classify constraints before stack selection:

LevelExamplesHandling
HardCompliance, security baseline, SLA, accessibilityMust satisfy
SoftStyle preferences, team familiarity, optional librariesCan be traded with rationale
OpenAreas where innovation is encouragedExplore alternatives

This prevents over-restrictive prompts like fixed color/component diktats while preserving quality.

3. Option Space Before Commitment

Generate at least 3 implementation candidates before locking architecture.

OptionShapeStrengthRisk
ConservativeProven stack, low noveltyPredictable deliveryLower differentiation
BalancedModern defaults + selective innovationStrong quality/speed trade-offModerate complexity
FrontierHigh-leverage novel approachDifferentiation and long-term upsideHigher execution risk

4. ADR-Lite Decision Record (Mandatory)

For each major decision, record:

  1. Context and constraints.
  2. Options considered.
  3. Chosen option + why.
  4. Risks and rollback path.
  5. Trigger conditions for revisiting the decision.

5. Domain-Fit Innovation Pass

For product-facing work (landing pages, SaaS UX, onboarding, dashboards), propose 3 domain-compatible ideas users may not ask for directly.

Example framing:

  • "If we add this concept, what user/job does it unlock?"
  • "How does this reduce cognitive load or decision friction?"
  • "Can this be implemented incrementally without architecture debt?"

6. Quality Gates (Before Final Output)

Do not finalize until these are explicit:

  • Functional correctness and edge cases
  • Security and data-safety checks
  • Performance budget assumptions
  • Maintainability and ownership clarity
  • Test strategy (unit/integration/e2e scope)

Behavioral Rule: Avoid Rigid Design Dictation

Do not force arbitrary style constraints like fixed colors/components unless user or brand context explicitly requires them.

Preferred approach:

  1. Offer 2-3 justified directions.
  2. Explain trade-offs clearly.
  3. Let constraints adapt to goals, audience, and product stage.
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: 468kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall