Repository navigation
docs(discern): add repository README and contributor setup - #6
Conversation
There was a problem hiding this comment.
Approved only for the README.md / CONTRIBUTING.md documentation slice under signed plan 169f4737c06aec92b842980222886f33113c573f.
Independent exact-head review at ccf7b313c46688b88c1e4a6d46f61b903eb34ca0 completed clean: no P0/P1/P2/P3 findings. Required checks at this head are green, including the gate (pnpm check:ci); the docs-only test matrix was skipped, not run. The reviewer successfully re-executed the published-package Quick Start. Full source installation was not rerun, and the scorer prose-density formula was not re-derived; these remain disclosed coverage limits.
This approval does not satisfy full SYS-1163 acceptance. The constitution subtree, ordinary setup, and template license require a separately authorized protected-stage plan. The root item and Linear SYS-1163 remain In Progress. Post-merge default-main checks and artifact/provenance verification are still required.
|
@Mergifyio queue |
|
Summary
Readers can evaluate the published package and contributors can set up the source workspace using the root README and contributor guide.
Copy provenance
One approved Gemini browser operation used 3.8 Flash All-around help / Flash High: https://gemini.google.com/app/2646efedc0e35116. The output was treated as a draft and source-checked; flattened Markdown was restored and unsupported human-review and recovery wording was removed.
Verification
@systemfsoftware/discern1.0.0 witheffect4.1.2. The example exited 0 and printedblock: rename User.id to User.key.write-readme-mdscorer returned 5/13 for the root README. The score is not proof of factual correctness.pnpm check:localrequirement remains pending off-host; it was not run as a full local gate. Mergify and default-main verification also remain pending.Unaltered README scorer output
{ "file": "README.md", "total": 5, "of": 13, "criteria": { "sections_5": { "pass": true, "count": 6 }, "sections_3": { "pass": true, "count": 6 }, "contributing": { "pass": true, "count": 1 }, "prose_density": { "pass": false, "count": 2.98 }, "relative_links": { "pass": true, "count": 4 }, "relative_links_3": { "pass": true, "count": 4 }, "emoji_3": { "pass": false, "count": 0 }, "emoji_10": { "pass": false, "count": 0 }, "emoji_20": { "pass": false, "count": 0 }, "details_3": { "pass": false, "count": 0 }, "tables_10": { "pass": false, "count": 0 }, "blockquote": { "pass": false, "count": 0 }, "blockquote_3": { "pass": false, "count": 0 } } }