LLD interview
Resolve decisions that a developer cannot safely infer from the approved HLD and repository evidence.
This runs in the lead agent so the grouped conversation and subsequent LLD write share one context.
Read boundary
Read the approved parent HLD, its deferred-question ledger, confirmed LLD decisions, repository
guidance, the maintained codebase map, relevant manifest, and only source/tests around the seam this
feature changes. Start from paths named by the map. Do not scan the whole repository or another repo.
Decide from evidence before asking
Do not ask the user to choose a normal implementation detail when the repository already has a clear
convention. Record no question for choices the writer can safely make from code evidence. Ask only an
unresolved decision that materially changes correctness, compatibility, or the implementation seam:
- which existing module or extension seam owns ambiguous behavior;
- local state authority, lifecycle, validation, or migration where the HLD leaves alternatives;
- this repo's precise side of an API, event, navigation, storage, or background-work boundary;
- for an API-producing backend, unresolved persistence ownership or client-contract facts: entity
relationships, destructive behavior, route/operation shape, complete DTOs, authorization, stable
errors, pagination, time/enum representation, idempotency, refresh and shared-contract ownership;
- visible error, retry, concurrency, idempotency, offline, or recovery behavior;
- authorization, privacy, sensitive-data handling, or trust-boundary enforcement;
- backward compatibility, rollout, backout, or support for relevant execution modes;
- a verification seam when materially different choices change testability or delivery risk.
Do not reopen PRD or HLD decisions. Do not ask for filenames, class names, boilerplate, library syntax,
task estimates, styling preferences, or facts directly discoverable from source. Do not ask a
frontend developer to rediscover a backend payload later: resolve material client-visible ambiguity
before writing. Recommend the simplest option that follows current repository patterns.
Answer audit
- Check every saved answer against its
must_resolve facts and against code/HLD constraints.
- For
source: user-answer, only answer is confirmed; proposal text is not.
- Follow up only on the missing or contradictory fact, using a new stable ID.
- A blocking repo decision cannot be deferred. An implementation detail with a safe existing
convention should be decided by the writer, not sent back to the user.
Queue contract
Write the supplied queue as schema version 2. Each question has id, title, question, why,
proposal, and one to four short must_resolve facts. Use 3–7 questions when several material gaps
remain and fewer when nearly clear. An empty queue requires empty audit.unresolved and
audit.contradictions. Run the supplied validator before completing.
Presentation
Use only the workflow's native grouped popup. If the host limits popup size, collect consecutive
chunks without analyzing or writing between them, then record the complete round atomically. Never
fall back to ordinary chat.
Safety
Write only the workflow-supplied question queue. Never edit the LLD, source, parent artifacts, or
state.
Output contract
Return summary: one short sentence describing the queue or confirming the repo is clear.
1---2name: lld-interview3description: Clarify only material repository implementation decisions before one repo LLD is written. Audit existing answers, inspect the bounded implementation seam, and ask feature-specific questions in grouped native popups.4---56# LLD interview78Resolve decisions that a developer cannot safely infer from the approved HLD and repository evidence.9This runs in the lead agent so the grouped conversation and subsequent LLD write share one context.1011## Read boundary1213Read the approved parent HLD, its deferred-question ledger, confirmed LLD decisions, repository14guidance, the maintained codebase map, relevant manifest, and only source/tests around the seam this15feature changes. Start from paths named by the map. Do not scan the whole repository or another repo.1617## Decide from evidence before asking1819Do not ask the user to choose a normal implementation detail when the repository already has a clear20convention. Record no question for choices the writer can safely make from code evidence. Ask only an21unresolved decision that materially changes correctness, compatibility, or the implementation seam:2223- which existing module or extension seam owns ambiguous behavior;24- local state authority, lifecycle, validation, or migration where the HLD leaves alternatives;25- this repo's precise side of an API, event, navigation, storage, or background-work boundary;26- for an API-producing backend, unresolved persistence ownership or client-contract facts: entity27 relationships, destructive behavior, route/operation shape, complete DTOs, authorization, stable28 errors, pagination, time/enum representation, idempotency, refresh and shared-contract ownership;29- visible error, retry, concurrency, idempotency, offline, or recovery behavior;30- authorization, privacy, sensitive-data handling, or trust-boundary enforcement;31- backward compatibility, rollout, backout, or support for relevant execution modes;32- a verification seam when materially different choices change testability or delivery risk.3334Do not reopen PRD or HLD decisions. Do not ask for filenames, class names, boilerplate, library syntax,35task estimates, styling preferences, or facts directly discoverable from source. Do not ask a36frontend developer to rediscover a backend payload later: resolve material client-visible ambiguity37before writing. Recommend the simplest option that follows current repository patterns.3839## Answer audit4041- Check every saved answer against its `must_resolve` facts and against code/HLD constraints.42- For `source: user-answer`, only `answer` is confirmed; proposal text is not.43- Follow up only on the missing or contradictory fact, using a new stable ID.44- A blocking repo decision cannot be deferred. An implementation detail with a safe existing45 convention should be decided by the writer, not sent back to the user.4647## Queue contract4849Write the supplied queue as schema version 2. Each question has `id`, `title`, `question`, `why`,50`proposal`, and one to four short `must_resolve` facts. Use 3–7 questions when several material gaps51remain and fewer when nearly clear. An empty queue requires empty `audit.unresolved` and52`audit.contradictions`. Run the supplied validator before completing.5354## Presentation5556Use only the workflow's native grouped popup. If the host limits popup size, collect consecutive57chunks without analyzing or writing between them, then record the complete round atomically. Never58fall back to ordinary chat.5960## Safety6162Write only the workflow-supplied question queue. Never edit the LLD, source, parent artifacts, or63state.6465## Output contract6667Return `summary`: one short sentence describing the queue or confirming the repo is clear.
keyvaluesoftwaresystems