Development record
README.md's 'It starts with the brief' section claims in present tense that abcd 'has a skill that ingests that material and produces a plain-language draft of your project's brief' and that you sharpen it with 'a Socratic interview the framework provides' — but abcd ships zero skills (surface is commands-only) and the grill/Socratic interview is an unshipped planned intent (itd-27), an unmarked not-yet-real claim the README's own honesty rule forbids
README.md's 'It starts with the brief' section claims in present tense that abcd 'has a skill that ingests that material and produces a plain-language draft of your project's brief' and that you sharpen it with 'a Socratic interview the framework provides' — but abcd ships zero skills (surface is commands-only) and the grill/Socratic interview is an unshipped planned intent (itd-27), an unmarked not-yet-real claim the README's own honesty rule forbids
Evidence
README.md"It starts with the brief" — present-tense "abcdhas a skill that ingests that material and produces a plain-language draft of your project's brief" and "a Socratic interview the framework provides".docs/reference/terminology.mdand.abcd/development/brief/05-internals/08-skills.md: "abcd ships zero skills" (commands-only surface); noskills/dir orSKILL.mdexists, and no command/agent drafts a brief.- The grill / Socratic interview is planned intent
itd-27(.abcd/development/intents/planned/);.abcd/development/brief/04-surfaces/README.mdsays theintentparent "ships nogrillsub-verb yet". README.mdstates its own rule earlier: "every ambitious passage is visibly marked as not yet real" — this passage is unmarked.
Adversarial review
CONFIRMED (substantive) by two independent refuters (one per claim half): both halves name unshipped capability in unmarked present tense, breaking the README's own honesty rule. Fix: mark the passage as a not-yet-real design target in the README's own idiom.
Frontmatter
| id | iss-295 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | minor |
.abcd/work/issues/resolved/iss-295-readme-md-s-it-starts-with-the-brief.md
open on GitHub ↗ · commit history ↗
mentions2
- dcn-26081900000000032026-08-19 — bughunt round 1 (branch bughunt-b/round-1): captured iss-291..iss-304 and fixed
- itd-27Domain Experts Get Their Intents Grilled Before Anyone Codes Them