Skip to content

feat: intent reads top-down; an answer is not approval (v2.10.0) - #52

Merged
cskwork merged 1 commit into
devfrom
feat/v2.10.0-intent-readability
Oct 20, 2026
Merged

cskwork merged 1 commit into
devfrom
feat/v2.10.0-intent-readability

Conversation

@cskwork

@cskwork cskwork commented Oct 20, 2026

Copy link
Copy Markdown
Owner

Summary

  • templates/intent.md: three-line Bottom line first (Changes = outcome, Left out, Needs you); human sections (Request, Understood as, Risks, Delivery, Blocking questions) above a ---; the agent's record (Terms, Clarity, new Facts) below. Clarity cells cite F1 IDs; each fact appears once.
  • phases/1-intent.md: attention-kind writing rule (one idea per line, bold lead-in, exact numbers, warnings on their line, requester's language with headings/field labels/Clarity words in English). Gate shows Bottom line, Risks and assumed Clarity, asks "is this what you want?" and ends the turn.
  • sdlc.sh: approve intent --human refuses a note (≥12 bytes) contained in a resolved blocking-question answer, compared as the parser reads it. Motivation: a real run recorded the requester's Q1 answer as whole-intent approval.

Tested

  • bash tests/selftest.sh → PASS 127 (new cases: exact answer, Resolved: + bold + short Korean answer, comment false positive). Budgets: 5998/6000 words, sdlc.sh 599/600 lines.
  • A real filled intent rewritten in the new layout parses to the same state as the old one (NEEDS-HUMAN intent).
  • Independent adversarial review: 1 major (guard bypasses) + 6 minor, all fixed.

Known limit

A generic phrase that is also inside an answer ("yes, go ahead") is refused as approval; record the human's fuller words.

- intent.md 맨 위 ## Bottom line(Changes·Left out·Needs you), Outcome 줄은 Changes로 통합
- 순서: Bottom line, Request, Understood as, Risks, Delivery, Blocking questions, --- 아래 에이전트 기록(Terms, Clarity, Facts)
- ## Facts(F1..): Clarity 칸은 한 문장 + 근거 ID, 한 사실은 한 곳에만 쓰고 나머지는 인용
- phase 1 작성 규칙: 한 줄 한 생각, 굵은 리드인, 정확한 숫자, 경고는 그 줄에, 요청자 언어(헤딩·필드·Clarity 단어는 영어)
- Gate: Bottom line·Risks·assumed Clarity를 보이고 "이게 원하는 것인가?" 후 턴 종료
- approve intent --human: 파서가 읽은 resolved 답변에 포함된 12바이트 이상 문구는 거부(대소문자·마크다운·주석 정규화)
- 단어 예산 안(5998/6000), sdlc.sh 599/600줄, selftest PASS 127
@cskwork
cskwork merged commit 92716ff into dev Oct 20, 2026
3 checks passed
@cskwork
cskwork deleted the feat/v2.10.0-intent-readability branch October 20, 2026 02:53
cskwork added a commit that referenced this pull request Oct 21, 2026
feat: intent reads top-down; an answer is not approval (v2.10.0)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant