FE-579: Greenfield/brownfield first-screen + exploration by lunelson · Pull Request #44 · hashintel/brunch

lunelson · 2026-04-12T15:58:54Z

chore: ln-sync + ln-handoff after slices 17a and 14

Sync: updated dependency graph (14 done), parallelism notes (14a next),
coverage table (6 file count corrections + api-types.test.ts), added
BrunchProject to lexicon.

Handoff: captures session state for resumption.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

feat: greenfield/brownfield first-screen routing and codebase exploration

Project creation now routes between greenfield (blank concept) and
brownfield (existing codebase). Brownfield interviewer gets core tools,
an exploration-first system prompt, and a higher step budget (12 vs 4).
Server derives cwd from launcher context, not from the client.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

chore: ln-review findings from slice 14a appended to REFACTOR.md

Four structural findings from the brownfield mode review integrated
into the existing type-deduplication refactor plan.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

chore: rewrite REFACTOR.md with verified duplication map and parallel streams

Verified all assertions from the original plan against the actual
codebase. Restructured 11 sequential commits into prereq → 4 parallel
streams → cleanup for concurrent agent execution.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

refactor: stabilize shared primitive exports for type deduplication

Export reviewStatusSchema, impactSchema, edgeRelationSchema, and
re-export WorkflowPhase from shared/api-types.ts. These named
exports enable parallel consumer streams to collapse their local
literal unions onto shared imports.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

refactor: collapse client phase primitives onto shared imports

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

refactor: narrow fixture manifest types to shared contracts

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

refactor: collapse interview mode and mutation types onto shared contracts

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

refactor: collapse server workflow primitives onto shared imports

WorkflowPhaseStatus, ReadinessBand, ReviewStatus, and ProjectMode in
db.ts now import from shared/api-types.ts and re-export for downstream
compatibility. No behavior change.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

chore: delete REFACTOR.md — type deduplication complete

All 4 parallel streams landed. Remaining client-side ReviewStatus
literals in knowledge-card.tsx and EntitySidebar.tsx are legitimate
local view-model types, not contract duplications.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

linear · 2026-04-12T15:58:59Z

FE-579 Greenfield/brownfield first-screen + exploration

First screen routes between greenfield (blank concept) and brownfield (existing codebase). Project records store mode and cwd. Brownfield adds core tools to interviewer, brownfield system prompt variant instructs explore-then-interview on first turn. Observer extracts from that turn as usual

lunelson · 2026-04-12T15:59:42Z

This stack of pull requests is managed by Graphite. Learn more about stacking.

augmentcode · 2026-04-12T16:04:17Z

🤖 Augment PR Summary

Summary: Implements greenfield vs brownfield project creation and first-turn codebase exploration, plus a docs sync + handoff snapshot.

Changes:

Adds DB migration + schema fields on project for mode (greenfield/brownfield) and cwd.
Extends shared API contracts to include mode/cwd, plus exports shared primitives (impact, edge relation, review status, workflow phase).
Replaces prompt-based project naming with a dialog flow that collects name then mode selection.
Updates server app creation to accept options and derive brownfield cwd from launcher/server context rather than the client.
Configures the interviewer to use a brownfield exploration-first system prompt, adds core tools in brownfield mode, and increases the brownfield step budget (12 vs 4).
Adds/updates tests across server + client to cover new mode/cwd plumbing and brownfield configuration.

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 5 suggestions posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-04-12T16:04:18Z

-  const closeability = getCurrentWorkflowState(db, projectId).phases[phase].closeability;
+  const tools = getInterviewerTools(db, turnId, phase, projectId, options);
+  const isBrownfield = options?.mode === 'brownfield' && options.cwd;
+  const instructions = isBrownfield ? getBrownfieldScopePrompt(options.cwd!) : getSystemPrompt(phase);


src/server/interview.ts:220 — createInterviewerAgent switches to getBrownfieldScopePrompt based only on mode/cwd, so brownfield projects will use a scope-specific prompt even when phase is design/requirements/criteria (prompt + tool behavior may be incorrect for those phases).

Severity: high

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-04-12T16:04:18Z

+    ...(canProposePhaseClosure(phase, closeability)
+      ? { propose_phase_closure: createProposePhaseClosureTool(db, turnId, phase, projectId) }
+      : {}),
+    ...(options?.mode === 'brownfield' && options.cwd ? createCoreTools(options.cwd) : {}),


src/server/interview.ts:207 — createCoreTools() currently includes write_file/edit_file (and bash), so brownfield interviewer mode enables repo mutation capabilities in addition to exploration, which is broader than the exploration-oriented toolset described in docs/design/BROWNFIELD_EXPLORATION.md.

Severity: high

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-04-12T16:04:18Z

 export const createProjectRequestSchema = z.object({
  name: z.string().trim().min(1),
+  mode: projectModeSchema.optional(),
+  cwd: z.string().optional(),


src/shared/api-types.ts:77 — createProjectRequestSchema allows a client-supplied cwd, but the server derives cwd from launcher context and ignores request cwd, so the shared API contract is misleading and may invite incorrect usage by other clients.

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-04-12T16:04:18Z

    await waitFor(() => {
      expect(fetchMock).toHaveBeenCalledWith(
        '/api/projects',
        expect.objectContaining({


src/client/routes/ProjectList.test.tsx:112 — This greenfield creation test no longer asserts the POST request body (e.g., that it includes the project name/mode), so a regression in payload construction could still pass while navigation is mocked.

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-04-12T16:04:19Z

@@ -0,0 +1,95 @@
+# Handoff — 2026-04-12


HANDOFF.md:1 — Process: this PR title doesn’t follow the required {issue-id}: {Linear issue title...} convention (e.g. FE-534: ...) per (Rule: AGENTS.md).

Severity: low

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

lunelson · 2026-04-12T17:03:49Z

Merge activity

Apr 12, 5:03 PM UTC: A user started a stack merge that includes this pull request via Graphite.
Apr 12, 5:08 PM UTC: Graphite rebased this pull request as part of a merge.
Apr 12, 5:09 PM UTC: @lunelson merged this pull request with Graphite.

Sync: updated dependency graph (14 done), parallelism notes (14a next), coverage table (6 file count corrections + api-types.test.ts), added BrunchProject to lexicon. Handoff: captures session state for resumption. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…tion Project creation now routes between greenfield (blank concept) and brownfield (existing codebase). Brownfield interviewer gets core tools, an exploration-first system prompt, and a higher step budget (12 vs 4). Server derives cwd from launcher context, not from the client. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Four structural findings from the brownfield mode review integrated into the existing type-deduplication refactor plan. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

… streams Verified all assertions from the original plan against the actual codebase. Restructured 11 sequential commits into prereq → 4 parallel streams → cleanup for concurrent agent execution. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Export reviewStatusSchema, impactSchema, edgeRelationSchema, and re-export WorkflowPhase from shared/api-types.ts. These named exports enable parallel consumer streams to collapse their local literal unions onto shared imports. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…racts Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

WorkflowPhaseStatus, ReadinessBand, ReviewStatus, and ProjectMode in db.ts now import from shared/api-types.ts and re-export for downstream compatibility. No behavior change. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

All 4 parallel streams landed. Remaining client-side ReviewStatus literals in knowledge-card.tsx and EntitySidebar.tsx are legitimate local view-model types, not contract duplications. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

lunelson marked this pull request as ready for review April 12, 2026 15:59

This was referenced Apr 12, 2026

FE-578: UI refinements; design adaptations & alignments #42

Merged

FE-545: Local-first storage; npx distribution #43

Merged

augmentcode Bot reviewed Apr 12, 2026

View reviewed changes

lunelson mentioned this pull request Apr 12, 2026

FE-580: Collapse remaining shared transport and review-status type duplication #45

Merged

lunelson changed the title ~~chore: ln-sync + ln-handoff after slices 17a and 14~~ FE-579: Greenfield/brownfield first-screen + exploration Apr 12, 2026

lunelson changed the base branch from ln/fe-545-storage-and-distro to graphite-base/44 April 12, 2026 17:06

lunelson changed the base branch from graphite-base/44 to main April 12, 2026 17:07

lunelson and others added 10 commits April 12, 2026 17:08

chore: ln-review findings from slice 14a appended to REFACTOR.md

7079e9c

Four structural findings from the brownfield mode review integrated into the existing type-deduplication refactor plan. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

refactor: collapse client phase primitives onto shared imports

2ad5b7b

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

refactor: narrow fixture manifest types to shared contracts

917214e

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

refactor: collapse interview mode and mutation types onto shared cont…

019af8e

…racts Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

lunelson force-pushed the ln/fe-579-codebase-exploration branch from 4c04af8 to 4aa052c Compare April 12, 2026 17:08

lunelson merged commit ded3c20 into main Apr 12, 2026
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FE-579: Greenfield/brownfield first-screen + exploration#44

FE-579: Greenfield/brownfield first-screen + exploration#44
lunelson merged 10 commits into
mainfrom
ln/fe-579-codebase-exploration

lunelson commented Apr 12, 2026

Uh oh!

linear Bot commented Apr 12, 2026

Uh oh!

lunelson commented Apr 12, 2026 •

edited

Loading

Uh oh!

augmentcode Bot commented Apr 12, 2026

Uh oh!

augmentcode Bot left a comment

Uh oh!

augmentcode Bot Apr 12, 2026

Uh oh!

augmentcode Bot Apr 12, 2026

Uh oh!

augmentcode Bot Apr 12, 2026

Uh oh!

augmentcode Bot Apr 12, 2026

Uh oh!

augmentcode Bot Apr 12, 2026

Uh oh!

lunelson commented Apr 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

lunelson commented Apr 12, 2026

Uh oh!

linear Bot commented Apr 12, 2026

Uh oh!

lunelson commented Apr 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

augmentcode Bot commented Apr 12, 2026

Uh oh!

augmentcode Bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

lunelson commented Apr 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merge activity

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

lunelson commented Apr 12, 2026 •

edited

Loading

lunelson commented Apr 12, 2026 •

edited

Loading