Skip to content

docs(discovery): apply quality review suggestions to session 1#4

Closed
nullhack wants to merge 10 commits into
mainfrom
docs/discovery-quality-review
Closed

docs(discovery): apply quality review suggestions to session 1#4
nullhack wants to merge 10 commits into
mainfrom
docs/discovery-quality-review

Conversation

@nullhack

Copy link
Copy Markdown
Owner

Summary

  • Consolidate overlapping questions in discovery journal (N2/N10, I1/I5, S1/S3, Q8/Q8-CLI-diff)
  • Reformat long single-cell answers with sub-bullets for readability
  • Add per-feature question justifications for hatch / config-reading / deprecation-sync
  • Add architectural cross-cutting gaps (A1–A4) scheduled for future session
  • Correct N2: nest is run once per repo, not repeatedly by contributors

Acceptance Criteria

N/A — this PR contains only documentation and discovery artifacts; no code changes.

Reviewer Notes

  • All changes are to docs/discovery.md and docs/discovery_journal.md
  • No .feature criteria were modified; no test or source code changed
  • This is a follow-up quality pass on Session 1 discovery outputs

nullhack added 10 commits April 21, 2026 02:19
Adds Rule: blocks with @id-tagged Examples to all 14 baselined features:

- nest, config-reading, id-generation, status

- cache-management, template-customization

- sync-create, sync-update, sync-cleanup

- adapter-contract, pytest-adapter

- parameter-handling, deprecation-sync

- hatch

All criteria frozen after this commit.
…tions

- deprecation-sync: cascade is absolute, no override in v1

- hatch: 1-2 bee-themed demo files covering common patterns

- Add living glossary at docs/glossary.md

- Journal and discovery.md updated with supplement session
- Replace pytest-beehave plugin description with beehave standalone library

- Document CLI commands: nest, hatch, sync, status, version

- Add framework-agnostic and adapter-contract explanations

- Add relationship to future pytest-beehave wrapper

- Update installation, quick start, and CI sections
- Consolidate overlapping questions (N2/N10, I1/I5, S1/S3, Q8/Q8-CLI-diff)
- Reformat long answers with sub-bullets for readability
- Add per-feature question justifications for hatch/config-reading/deprecation-sync
- Add architectural cross-cutting gaps (A1-A4) for future session
- Correct N2: nest is run once per repo, not repeatedly by contributors
@nullhack nullhack closed this May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant