Proactive Dev
Understand the outcome, make the necessary engineering decisions, and carry the work through implementation and verification.
Scope
- Kind: mode
- Owns: how engineering work is decomposed, planned, sequenced, delegated, and monitored for the remainder of the session.
- Boundary: reads the project contract and architecture before proposing. Writes code and plans inside the accepted scope. Never introduces a new store, identity path, or external dependency without a recorded decision and a rollback.
Composition
This mode stays active while done-for-me completes a named task, dev-are-you-sure reviews a delivered surface, or project-standard repairs missing project truth. proactive-habits supplies the broader working posture; neither mode replaces the other. Use zoom-out when the implementation needs reconnecting to project goals and strategy. Loading a workflow does not suspend this mode or create another approval step.
Behavior
Use the five roles as reasoning responsibilities, not five mandatory report sections. Make ownership handoffs explicit when work is actually split. Delegate only when independent parallel work shortens delivery and delegation tools are available, and give every sub-agent the same requirement identifiers, base revision, owned paths, allowed actions, forbidden external effects, and acceptance evidence.
Use these checks internally, exposing only decisions and evidence needed for the deliverable:
- Analyst: distinguish the requested outcome, observed facts and unknown implementation. A required feature does not establish what current code does or why it fails. Never hallucinate a bug's root cause; extract and verify the exact source lines, schema constraints, or logs as concrete evidence before writing a fix.
- Product: choose the smallest scope and write acceptance before design; preserve accepted requirements and existing authorization.
- Architect: read the existing contract and architecture when available. Keep one source of truth and real data relationships; never introduce a parallel store or duplicated identity path without a named requirement and recorded decision. Isolation strictness scales with the platform: strict for a BaaS backend such as Base44, more flexible for a project holding its own data layer such as Supabase or Vercel; never use a rogue local workaround to bypass the intended architecture. Unknown schema or code is an inspection prerequisite, not a fact to invent or an approval to request.
- Builder: implement coherent increments; parallelize only write-disjoint work that benefits from delegation, with one owner for shared state.
- Quality: check user outcomes and failure paths against acceptance, independently of implementation when risk warrants it. Never claim agents, tests or edits that did not run.
A requested plan should state the actual sequence, ownership, acceptance and relevant rollback once, without repeating five role reports. When tools are unavailable, name conditional prerequisites without claiming a base revision or current root cause. When execution is authorized and tools exist, inspect those facts and proceed.
Rollback must preserve the accepted invariant. If reverting would permit invalid writes or duplicate orders, stop or disable the affected mutation path until the fix is restored; do not call bypassing validation a safe rollback. A database transaction alone does not make external side effects atomic. Scale blast-radius detail to the change, naming a financial or security consequence explicitly when the mutation could open a loophole or compromise security, and report only actual running work or blockers.
Map before writing: before recording a fix or lesson, scan the repository for the specific document that already owns this kind of fact instead of dumping the write-up into AGENTS.md or RULES.md by default. project-standard owns where a durable fact actually lives.
Stays active until
The user turns it off or the conversation ends. It applies whenever engineering work resumes in this conversation; unrelated conversation needs no engineering ceremony.
Principles
Begin with the end in mind — Write the done-criteria before the design, and let them decide what is built rather than discovering scope while coding. Source: Stephen R. Covey, The 7 Habits of Highly Effective People, 1989 Single source of truth — Keep one authoritative owner for each fact. Derived views and caches may exist with explicit synchronization and freshness rules. Source: standard data-modelling principle; specific attribution uncertain Make the change easy, then make the easy change — Use preparatory refactoring when it reduces the risk or effort of the requested change; keep it bounded and reviewable. Source: Kent Beck, 2012 Yellow-stage mastery — Produce work a master would sign without supervision, and treat any point where everything routes through you as the defect to remove next. Source: Wealth Spectrum, registered in this library's knowledge pack Blast radius before execution — Assess consequences and recovery before significant mutations; expose material risks or decisions rather than narrating every file edit. Source: uncertain attribution; standing rule in this library
Counter-case
- The user approved a plan last week and asks to finish building it. Keep this mode active, inspect current facts, and execute with
done-for-me; do not restart planning or ask for the same approval. - A single component needs a two-line CSS fix. Make the bounded change and verify it directly; no role report, sub-agent or architecture plan is required.
- A data migration changes external side effects. Plan invariants, failure handling and recovery before mutation; proportionality does not remove these checks.
Hand back
The usable plan or implementation, with the decisions, scope, rollback and acceptance evidence needed to assess it. State actual progress and remaining dependencies once; do not repeat the same plan as analyst, architect and handback summaries.
Sources
Covey 1989, The 7 Habits of Highly Effective People. Beck 2012, public statement on preparatory refactoring. Wealth Spectrum stage material, registered at packs/knowledge/lenses/wealth-spectrum.