From 58aeaa50cb3fdef4e7f30989573d894f5d2da1b1 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Tue, 22 Sep 2026 00:09:02 +1000 Subject: [PATCH] docs(eda): strip status and editing narration from the positions PRD Headings carried scheduling status the Blocked-on line already states, and two paragraphs narrated how the document was written rather than what was decided. Both violate the PRD rule that every sentence adds a decision, requirement, constraint, evidence or verification step. --- docs/prds/channel-forge-positions.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/prds/channel-forge-positions.md b/docs/prds/channel-forge-positions.md index e960e77d0..72076f54a 100644 --- a/docs/prds/channel-forge-positions.md +++ b/docs/prds/channel-forge-positions.md @@ -7,7 +7,7 @@ implementation of either position. Both are side-effecting, and `t2db.17` resolved the keying scheme in design only. -## Forge: ready to implement once the ledger lands +## Forge `internal/forge.Forge` is already exactly the shape a native-Go action position needs -- a real, typed, general-purpose interface, not something @@ -31,8 +31,7 @@ should be: a small set of named operations (e.g. `close-issue`, `create-pr`, `link-branch`), each with a typed `Args`/`Result` struct mirroring the matching method's parameters/return. -**Correction (2026-09-03, caught in review before this landed as settled -design):** the dispatch target must be `internal/domain/workflow.Forger` +The dispatch target is `internal/domain/workflow.Forger` (`CloseIssue`/`CreatePR`/`LinkBranch` -- already exists, already exactly these three operations), **not** `internal/forge.Forge` directly. `organisation.md`'s target structure places `forge/` under @@ -59,10 +58,9 @@ proven on the simpler operations, don't design it blind now. existing instance into the coordinator's constructor), not a new extensibility mechanism. -## Channel: resolved 2026-09-22 +## Channel -Superseded: the 2026-09-03 section here presented two options and asked for a -decision. The decision is below; the options are not repeated. +Supersedes the 2026-09-03 open question on this position. ### Constraints this satisfies