docs(samples): add concrete sample content to all template documents#107
Merged
docs(samples): add concrete sample content to all template documents#107
Conversation
- Rewrite docs/system.md with full SA-owned structure: Summary, Actors, Structure, Key Decisions, External Dependencies, Active Constraints, Domain Model (Entities, Actions, Relationships), Context (C4L1 Mermaid), Container (C4L2 Mermaid), ADR Index, Completed Features - Add docs/glossary.md with five domain terms from display-version feature - Add docs/adr/ADR-2026-04-22-version-source.md and verbosity-validation.md - Fill docs/discovery.md, docs/scope_journal.md with display-version session - Remove standalone docs/context.md and docs/container.md — consolidated into system.md as ## Context and ## Container sections - Update docs/index.html: context.md card → system.md#context (C4 Diagrams) - Update WORK.md: append correction entry for domain-model.md/context.md refs - Carry forward previously staged workflow and skill improvements
This was referenced Apr 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
system.md,glossary.md,discovery.md,scope_journal.md, two ADRs) using thedisplay-versionfeature as the concrete example throughoutsystem.mdas## Contextand## Containersections (SA-owned); delete standalonedocs/context.mdanddocs/container.mdChanges
docs/system.md— full rewrite: Summary, Actors, Structure, Key Decisions, External Dependencies, Active Constraints, Domain Model (Entities, Actions, Relationships), C4 Context Mermaid, C4 Container Mermaid, ADR Index, Completed Featuresdocs/glossary.md— new file with five domain terms fromdisplay-versiondocs/adr/ADR-2026-04-22-version-source.md— new ADR: read version frompyproject.tomlviatomllibdocs/adr/ADR-2026-04-22-verbosity-validation.md— new ADR: validate verbosity against closed setdocs/discovery.md,docs/scope_journal.md— concrete session entries fordisplay-versiondocs/context.md,docs/container.md— deleted; content consolidated intosystem.mddocs/index.html— "Context Diagram" card updated to linksystem.md#contextWORK.md— correction entry appended to session logReviewer Notes
No code changes. All changes are documentation and workflow template files. The
display-versionfeature (already incompleted/) is used as the reference example across all documents so every placeholder has a realistic, internally consistent value.