8000 docs: the v1.3 spec, ADR 0012 and the build order by kiran-brahma · Pull Request #91 · kiran-brahma/writing-tool · GitHub
[go: up one dir, main page]

Skip to content

docs: the v1.3 spec, ADR 0012 and the build order - #91

Merged
kiran-brahma merged 4 commits into
mainfrom
v1.3
Sep 26, 2026
Merged

kiran-brahma merged 4 commits into
mainfrom
v1.3

Conversation

@kiran-brahma
Copy link
Copy Markdown
Owner

Closes #56. Part of #57.

The docs that were missing when #90 merged, from docs/v1.3-the-page-and-the-mark, merged into v1.3. This PR changes docs only, no code.

  • docs/specs/obelus-v1.3.md: the v1.3 spec (the text of Spec — Obelus v1.3: the page and the mark #57).
  • docs/adr/0012-the-judge-is-a-rail-mode.md: the decision Rail modes: Findings and Judge #66 implements.
  • docs/decisions/the-page-and-the-mark-goldilocks.md: the design choice.
  • docs/build-order.md: the v1.3 and backlog tables. The 20 finished tickets are marked "- Completed". Decompose useRuns and useDocumentLifecycle further #52 stays open, handed back as ready-for-human.
  • docs/agents/issue-tracker.md: one line.
  • CONTEXT.md: the Writer's glossary. Rail, Rail mode, Status line, Callout and Margin mark conflicted with stand-in entries the tickets had added, and the Writer's text is kept for each. The file now matches the docs branch.

Gates and tests (1117) pass on the head.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FjB3Gu8vhg5enkAneTdqga


Generated by Claude Code

kiran-brahma and others added 4 commits September 26, 2026 10:58
v1.3 gives Obelus an identity in two places, the page and the mark, and
keeps everything around them quiet: the prose in a bundled book serif at a
reading measure, Highlights in blue pencil underlined at rest, a Margin mark
beside each Paragraph where open Findings begin, colour named by meaning
with a Light | Dark | System choice, the Rail in two Rail modes, the
Outline in the left margin on wide screens, and the Rail overlaying the
prose below 1024px.

- The spec is docs/specs/obelus-v1.3.md, published as #57 and split into
  #58–#69.
- ADR 0012 makes the Judge a Rail mode, superseding one sentence of ADR
  0010 and keeping its four properties.
- The Goldilocks review chose semantic colour tokens, Margin marks as
  widgets between blocks, one media-query flag for the narrow layout, and
  an unstored Rail mode.
- CONTEXT.md gains Margin mark, Rail mode and Status line.
- The build order marks v1.2 complete, names v1.3 the frontier, and
  sequences the colour refactor expand–contract (#58, then #59–#61, then
  #62).

Closes #56

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ided

#45–#55 join the build order as steps 45–53, with the Writer's decisions
on #48 (correct the docs), #51 (accept and document), #54 (true call
count) and #52 (hand to an agent, last) recorded on each issue. #53 waits
for #66, which rebuilds the Finding row; #52 waits for every terminal v1.3
ticket. Combined waves cover the whole run to an empty tracker.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Brings in the v1.3 spec, ADR 0012, the goldilocks decision and the v1.3
and backlog build order. CONTEXT.md conflicted where the tickets had
added stand-in entries for Rail, Rail mode, Status line, Callout and
Margin mark; the Writer's glossary text is kept for each.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FjB3Gu8vhg5enkAneTdqga
#52 stays open: handed back to the Writer (ready-for-human, needs-info).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FjB3Gu8vhg5enkAneTdqga
@chatgpt-codex-connector
chatgpt-codex-connector Bot commented Sep 26, 2026 •