Skip to content

docs: add Docs Toolkit design brief to agent context#924

Merged
zeevdr merged 1 commit into
mainfrom
docs-toolkit-brief
Jun 11, 2026
Merged

docs: add Docs Toolkit design brief to agent context#924
zeevdr merged 1 commit into
mainfrom
docs-toolkit-brief

Conversation

@zeevdr

@zeevdr zeevdr commented Jun 11, 2026

Copy link
Copy Markdown
Member

Summary

  • Epic Epic: decree-docs — advanced schema docs generator #921 requires a design brief in .agents/context/ before implementation starts; this adds it so every implementation agent works from one source of truth instead of re-deriving decisions.
  • Captures the goal, non-goals, architecture sketch, and the ten key decisions from the docs-generator discovery (contrib/ placement, format set, theming, template overrides, config precedence, inject mode, MDX escaping, Go tier).

Test plan

  • Docs-only change — no code paths affected; CI runs the standard suite on an unchanged tree.
  • Brief follows the existing .agents/context/ format (Goal / Non-goals / Key Decisions, cf. sdk-instrumentation.md).

Refs #921 (intentionally not Closes — the epic stays open until all child issues land)

The epic requires a design brief in .agents/context/ before implementation
starts. Captures the goal, non-goals, architecture, and the key decisions
from the docs-generator discovery (formats, theming, templates, config,
inject mode) so implementation agents share one source of truth.

Refs #921

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@zeevdr zeevdr added this to the Docs Toolkit milestone Jun 11, 2026
@zeevdr zeevdr added size: L Larger effort — multiple days, design decisions needed priority: P2 Nice-to-have labels Jun 11, 2026
@zeevdr zeevdr merged commit 26036b5 into main Jun 11, 2026
19 checks passed
@zeevdr zeevdr deleted the docs-toolkit-brief branch June 11, 2026 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: P2 Nice-to-have size: L Larger effort — multiple days, design decisions needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant