feat: add docs checker for ADRs and implementation plans #1

Merged
end merged 13 commits from feat/docs-checker into main 2026-10-23 15:56:04 -07:00
13 Commits
Author SHA1 Message Date
endandClaude Opus 5.5 e2ddd76536 docs: accept docs format ADR
ci / check (push) Successful in 18s
ci / check (pull_request) Successful in 17s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 15:55:31 -07:00
endandClaude Sonnet 5.5 694c43051e fix: harden docs checker heading lines, definitions and docs symlinks
ci / check (push) Successful in 59s
ci / check (pull_request) Successful in 58s
- N1: never call Lines() on inline nodes; locate empty ATX headings after the
  end of all preceding blocks (no panic, correct line after `***`)
- N2: take reference definition lines from ast.LinkReferenceDefinition and
  drop refCtx/defRe
- N3: reject docs/adr and docs/plans that resolve outside the repository

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 15:03:26 -07:00
endandClaude Sonnet 5.5 9eec1d1016 docs: specify docs directory and path-case rules
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:58:14 -07:00
endandClaude Sonnet 5.5 d579e38ba5 fix: address docs checker review findings
Check every link reference definition, decode destinations per CommonMark,
report correct lines for empty headings, autolinks and nested definitions,
reject symlinked record directories and wrong-case path components, and
refuse titles that cannot pass. Only top-level headings count (spec section 6).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:57:21 -07:00
endandClaude Sonnet 5.5 789931d90f docs: correct two statements in the format ADR
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:57:21 -07:00
endandClaude Sonnet 5.5 ddebde0b2e ci: keep goreleaser to a single token in the release job
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:57:21 -07:00
endandClaude Sonnet 5.5 e33e8df6c6 docs: record decision to adopt a checked docs format
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:47:46 -07:00
endandClaude Sonnet 5.5 e5c203d465 ci: add Gitea workflows and goreleaser config
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:47:38 -07:00
endandClaude Sonnet 5.5 750b7449b0 feat: add docs checker and record templates
docs new creates ADRs and plans from embedded templates; docs check reports
path:line: message problems per docs/docs-format.md.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:46:56 -07:00
endandClaude Sonnet 5.5 b0428256bd chore: add module, license and repository guides
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:46:56 -07:00
endandClaude Sonnet 5.5 f8a76a9ab0 docs: apply architecture review pass 2 fixes
Clarify null scalars, marker handling in frontmatter, the Decision Outcome
prose rule, section extent wording and link rule scope.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:39:25 -07:00
endandClaude Sonnet 5.5 4cdc29bf3f docs: revise format spec after review
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 14:36:06 -07:00
endandClaude Sonnet 5.5 b4fab41135 docs: add docs format specification
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-23 13:56:50 -07:00