Skip to content

Correct GOVERNANCE.md Repository Layout for Workflows, STANDUP.md, RESYNC.md, .agents, and host-setup #3768

Open

Description

@ptr727

Split from #1155 at the maintainer's direction (backlog-burndown run, 2026-11-01). This is item 3 of that issue's four. It was decided in #1155 (comment), and the decision text is quoted below.

3. GOVERNANCE.md "Repository Layout": fix all three. Re-describe .github/workflows/ as holding both this repository's own CI and the fleet's reusable task workflows, with the hub-specific half qualified so a carrier does not read it as a claim about itself. Add the root-level STANDUP.md and RESYNC.md. Add .agents/ and host-setup/ rows.

Activity

  1. ptr727 commented on Nov 2, 2026

    @ptr727
    OwnerAuthor

    Released (2026-11-02): PR #3818 merged to develop and its branch is deleted, so this claim holds no files. This issue was already done on develop before this round, by #1685, so nothing here closes it on promotion. The evidence is in the comment from the group worker. Closing it is left to the maintainer.

    Backlog burndown claim (away run 2026-11-02, round 2, group G3). Branch: burndown/3617-governance-prose. Issues: #3617, #3757, #3790, #3768.

    Predicted file set:

    • GOVERNANCE.md
    • .gitignore
    • .agents/skills/agent-conduct/ and its generated trees (.github/skills/agent-conduct/, .claude-plugin/fleet-skills/skills/agent-conduct/, .claude-plugin/fleet-skills/.source-digests/agent-conduct)

    Out of bounds for this group: scripts/README.md and catalog/snippets/ (group G1), .agents/skills/backlog-burndown/ and .agents/skills/git-commit-conventions/ (group G2), .github/workflows/* and .github/actions/* (open PR #3801), WORKFLOW.md.

    Scope: develop only. The feature pull request carries Closes on promotion: for each issue it fully fixes.

  2. ptr727 commented on Nov 2, 2026

    @ptr727
    OwnerAuthor

    Already done on develop, not part of #3818 (backlog-burndown away run 2026-11-02, round 2, group G3).

    Each item of the decision quoted above is present in GOVERNANCE.md "Repository Layout" at develop ab147bd. They were added by #1685 (merged 2026-09-18), which implemented items 1 to 3 of #1155 before that issue was split.

    • .github/workflows/: the row describes the repository's own CI and release workflows, and its hub-specific half is qualified ("The hub additionally holds the fleet's reusable task workflows, validate-task.yml and build-release-task.yml among them").
    • STANDUP.md, RESYNC.md: a row exists, marked hub-only.
    • .agents/ and host-setup/: a row exists for each, marked hub-only.

    So #3818 does not list this issue on its Closes on promotion: line, and nothing in this group changed that section. The issue is left open. Closing it is the maintainer's call.

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

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions