Skip to content

BuilderIO/agent-native / .agents/skills/build-an-app

build-an-app

Verified

Fast end-to-end workflow for turning this starter into a working domain app from a short or vague request. Use when asked to build, make, create, or prototype an app, tool, tracker, dashboard, booking, inventory, or CRM system with Agent-Native. Read before the first edit.

references/edit-points-default.md

View on GitHub
# Default scaffold edit points

Use only when `package.json["agent-native"].scaffold.template` is `default`.
This scaffold has a document/provider root and a sample `/home` route. It has
no Chat sidebar, `Layout.tsx`, `server/plugins/agent-chat.ts`, or
`INITIAL_TOOL_NAMES` list.

| File                                            | Change                                                                                                                           |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `server/db/schema.ts` (new)                     | Define PostgreSQL tables with `drizzle-orm/pg-core`; use the shared schema helpers when access/sharing needs them                |
| `server/db/index.ts` (new)                      | Export `getDb = createGetDb(schema)` and register shareable resources as needed                                                  |
| `server/plugins/db.ts` (new)                    | Add named, additive migrations with `runMigrations`                                                                              |
| `actions/<verb>-<noun>.ts`                      | One default-exported `defineAction` per file; the filename becomes the tool name                                                 |
| `app/routes.ts` and `app/routes/<domain>.tsx`   | `flatRoutes()` discovers route files; add the domain route and nested routes using the filename conventions already present      |
| `app/root.tsx`                                  | Keep the document, providers, and `<Outlet />`; do not replace it with a domain shell                                            |
| `app/hooks/use-navigation-state.ts`             | Extend the current path-derived navigation state only when the agent needs selected domain ids or filters beyond the current URL |
| `server/plugins/agent-native-email-branding.ts` | Set `app.homePath` to the requested authenticated home route; the create command adds this plugin when it renames the scaffold   |
| `AGENTS.md`                                     | Add a concise domain section with routes, invariants, state, and primary actions                                                 |

`app/routes/_index.tsx` is the sign-in landing route. `app/routes/home.tsx`
is the authenticated sample page. Preserve both unless the requested workflow
specifically replaces the home experience. The default template has no app
navigation shell to extend; add only the navigation the product needs.
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: 469kUpdated Claude CodeCodexVerifiedInstall
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