Skip to content

domain-driven-design: glossary layout, pressure-test observe, write-for-humans eval #7591

Closed
9 of 9 issues completed

Description

@kyle-sexton

Parent

Refs #7555. Source: PLAN Phase 23, topic poteto-review. Thread: Other plugins.

Depends on

Outcome

/domain-driven-design:curate-language proposes a GLOSSARY.md per bounded context plus a
GLOSSARY-MAP.md; /prototype:pressure-test gains observe; write-for-humans gets a grounding rule
only if an eval shows the gap.

Decisions

  • /domain-driven-design:curate-language proposes GLOSSARY.md per bounded context plus
    GLOSSARY-MAP.md, stays domain-only; replace the four UBIQUITOUS-LANGUAGE.md lookups; glossary
    grouping line (D70, Q51, Q75, Q525; Matt's current glossary layout). Setting: glossary paths
    GLOSSARY.md, GLOSSARY-MAP.md.
  • Teach glossary rules; questionnaire template drops em dashes (Q525).
  • /prototype:pressure-test gains observe; prototype evidence on a throwaway branch after the
    secrets check (Q167, Q168; combined: Lauren and Matt both keep prototype branches).
  • /docs-hygiene:write-for-humans grounding rule only if an eval shows the gap (Q526).
  • Rejected: CONTEXT.md (no difference in a 4-agent experiment, "context" overloaded); a third
    prototype skill; prototype evidence as a note only or pushed without the check.

Key interfaces

From the design's module layout: "domain-driven-design: curate-language proposes GLOSSARY.md
per bounded context plus GLOSSARY-MAP.md." "prototype: pressure-test gains observe."
Settings: "Glossary paths GLOSSARY.md, GLOSSARY-MAP.md."

Slices, filed when this phase starts: glossary, pressure-test-observe, write-for-humans-eval.

Done when

  • rg -c 'UBIQUITOUS-LANGUAGE' plugins --glob '!**/CHANGELOG.md' returns 0 (nonzero on main) and
    bash scripts/check-purged-em-dashes.sh exits 0.
  • The write-for-humans eval slice carries a Probe result: comment.
  • Every slice sub-issue is closed by a merged PR.

Out of scope

  • Dossier branches (Dossier thread), beyond sharing the secrets check.

Activity

  1. added
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Oct 16, 2026
  2. github-actions commented on Oct 16, 2026

    @github-actions
    Contributor

    Proposed work class: work-class: scoped
    Basis: automated intake triage; the lanes App applied this class.

    Size: Medium
    Complexity: Medium
    Uncertainty: Known
    Flags: none
    Blocked by: #7571

    Understood: update curate-language in domain-driven-design to propose a GLOSSARY.md per bounded context plus a GLOSSARY-MAP.md, replacing the UBIQUITOUS-LANGUAGE.md lookups. Add observe to prototype's pressure-test. Add a write-for-humans grounding rule only if an eval shows the gap. The outcome, decisions and done-when checks are specific, so I'm asking nothing further. The issue lists #7571 (glossary path settings) as a dependency, so I've recorded it as a blocker. I didn't find a likely duplicate among the open issues.

    Automated triage, applied by the lanes App.

  3. changed the issue type fromtoon Oct 16, 2026
  4. changed the issue type fromtoon Oct 16, 2026
  5. removed
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Oct 24, 2026
  6. kyle-sexton commented on Oct 24, 2026

    @kyle-sexton
    MemberAuthor

    Released for re-triage under the owner's 2026-10-24 rule: an issue stops for a person only for an intent or vision question, a security call, a host or attended run, or spend outside prepaid credit. The hold label came off and intake triage runs again now; it re-applies a hold, with a numbered question, when one of those applies.

    To hold this issue again, add needs-human (or status: needs-decision) and say why in a comment.

  7. 22 remaining items

  8. kyle-sexton commented on Nov 1, 2026

    @kyle-sexton
    MemberAuthor

    Decision recorded.

    Issue Triage session (agent), applying a decision recorded in the poteto-review interview ledger; this comment asserts no new owner decision.

    The issue lane stopped here with reason intent (comment 6556369883), asking what /prototype:pressure-test observe does and what check shows it is done. The poteto-review interview answered that as Q167. Its ledger records the owner's answer as "accepted as recommended audit A7" (.work/poteto-review/interview-checklist.md:212, a local session record), and decision row 99 records Q160, Q162 and Q165-Q169 as "APPROVED as recommended" (.work/poteto-review/GUIDE.md:209, owner 2026-10-15). The session's question the owner accepted, verbatim: "Should /prototype:pressure-test gain an observe option where the agent runs the variants of a fork a run can settle, records behavior, output and timing (timing labeled unqualified), and recommends, handing off to /performance:goal only when the fork is itself a performance target?" Recommended answer: "Yes, as described; the human keeps product and preference calls; the STOP gate for unrequested prototypes stays." Q168 (evidence on a throwaway branch after the repository's secrets and machine-data check) is recorded the same way (interview-checklist.md:213).

    The remaining work is split into sub-issues, each with its own done-when:

    This issue closes when every sub-issue closes by a merged pull request. needs-human comes off: the intent question has a recorded answer.

  9. removed
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Nov 1, 2026
  10. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  11. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  12. melodic-automation-lanes commented on Nov 3, 2026

    @melodic-automation-lanes
    Contributor

    This records a re-fire of an earlier refusal, not a new refusal. The lanes kill switch stopped run 41724819404, the work-resolve-issue run that agent-ready started, before it did any work; that run ended at 2026-11-03T23:45:18Z. work-unblock has now removed and added agent-ready back to start a fresh run. A kill-switch refusal is no fault in this issue or the lanes, so it never counts against later re-fires; after limits.limit-stops-per-issue of them since a person last added agent-ready or a run last reported, work-unblock waits longer before each one, up to 24 hours.

  13. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    and removed
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  14. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  15. github-actions commented on Nov 4, 2026

    @github-actions
    Contributor
    No description provided.
  16. melodic-automation-lanes commented on Nov 4, 2026

    @melodic-automation-lanes
    Contributor

    The work-resolve-issue lane stopped on this issue (verified-done): the issue is a finished parent, every sub-issue closed as completed, and the run checked each of its own done-when items against the default branch, citing each check, so the issue closes.
    It closes the issue as completed.

    In the run's words:

    verified-done: all three done-when items of #7591 hold on main 97ba98f: no UBIQUITOUS-LANGUAGE outside CHANGELOGs, the em-dash gate passes in lint-repo on main, slice #12025 carries Probe result: comments, and all nine sub-issues are closed as completed with their work in merged PRs.

    The run's report:

    Done when 1, rg -c 'UBIQUITOUS-LANGUAGE' plugins --glob '!**/CHANGELOG.md' returns 0 and bash scripts/check-purged-em-dashes.sh exits 0: met. A Grep for UBIQUITOUS-LANGUAGE under plugins/ (CHANGELOG.md excluded) on main 97ba98f found 0 occurrences in 0 files. The lane cannot run the em-dash script, but its CI step purged_em_dashes feeds scripts/aggregate-hygiene-results.sh in the lint-repo job (.github/workflows/pr-require-checks.yml:1821-1825, 2011, 2015), and any outcome other than success fails that job. lint-repo concluded success on main's own commit 97ba98f (https: //github.com/melodic-software/claude-code-plugins/actions/runs/41743362129/job/126290314904).
    Done when 2, the write-for-humans eval slice carries a Probe result: comment: met. Slice #12025 ("run the write-for-humans grounding eval and post its probe result") has comment 6563106833 (2026-11-01T19:58:28Z, "Probe result: Host run ... Verdict: gap shown.") and comment 6564348256 (2026-11-01T21:46:49Z, "Verdict: gap still shown.").
    Done when 3, every slice sub-issue is closed by a merged PR: met. #8544 closed after #8662 merged (2026-10-20T18:38:01Z). #8648 closed after #9554 merged (2026-10-24T03:34:36Z). #12022 closed after #12048 merged (2026-11-01T19:49:50Z). #12023 closed after #12034 merged (2026-11-01T21:06:01Z). #12024 closed after #12047 merged (2026-11-01T20:52:06Z). #12025 closed after #12127 merged (2026-11-02T00:21:55Z). #12026 closed after #12088 merged (2026-11-01T22:00:18Z). #12030 closed after #12220 merged (2026-11-02T02:55:59Z). Each of these closed 2 to 3 seconds after its PR merged. #12085 is the exception: kyle-sexton closed it by hand at 2026-11-03T21:43:43Z (state_reason completed, comment 6616155442) after an owner decision reworded its done-when 2. Both of its done-when items are ticked, and its work landed in three merged PRs that carry Refs: #12085: #12098 (grounding rule, merged 2026-11-01T21:11:08Z), #12199 (rule reworded, merged 2026-11-02T02:22:56Z) and #12941 (deterministic grader, merged 2026-11-03T21:33:43Z). I counted it as met because its deliverables are all merged PRs and it closed as completed. Flagged for a person: no PR merge triggered its close.

    What the run says it did not do:

    • scripts/check-purged-em-dashes.sh was not run in this lane, which runs no interpreter or repo script. Its exit status on main comes from the lint-repo job's success on commit 97ba98f.
    • #12085 closed by the owner's hand after a recorded decision, not by a PR's closing keyword. Its work is in merged PRs #12098, #12199 and #12941 (each Refs: #12085). A person may want to confirm this counts as 'closed by a merged PR'.
    • tidy, review, verify and the class audits were skipped: a verify_close run changes no file.

    Run: https://github.com/melodic-software/claude-code-plugins/actions/runs/41743077771

  17. removed
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-specNeeds a Brief or plan before anyone can build it.priority: mediumReal value, no hard deadline; normal backlog flow.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.

    Fields

    Work status

    needs-spec

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions