Skip to content

docs: add set-requirements to setup header and cite #12/#9 in [0.1.1] - #16

Closed
clawgenti wants to merge 1 commit into
rossoctl:mainfrom
clawgenti:update/doc-drift
Closed

clawgenti wants to merge 1 commit into
rossoctl:mainfrom
clawgenti:update/doc-drift

Conversation

@clawgenti

@clawgenti clawgenti commented Nov 5, 2026 •

Copy link
Copy Markdown
Collaborator

Rolling documentation updates from RepoMan doc-drift.

Changes

Note
This fixes entries in the existing [0.1.1] changelog section. It does not publish or edit a GitHub release.

Generated by RepoMan doc-drift-fixer (https://github.com/rossoctl/agent-skills/blob/main/skills/doc-drift-fixer/SKILL.md).

@clawgenti clawgenti changed the title docs: doc-drift updates for repoman docs: add set-requirements to setup header and cite #12/#9 in [0.1.1] Nov 5, 2026
@clawgenti clawgenti mentioned this pull request Nov 5, 2026
4 tasks
@jimcadden jimcadden added the ready-for-ai-review Request automated AI code review from clawgenti label Nov 5, 2026
@clawgenti clawgenti added the doc-drift Documentation drift tracked by RepoMan label Nov 5, 2026

@jimcadden jimcadden left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both changes check out against the tree; two wording/style nits inline, one stale line in the same section.

Verified

  • set-requirements is implemented (cmd_set_requirements, repoman-setup.sh:483) and was already advertised in usage() (:60); the file header was the only place missing it, so the comment change now matches the script.
  • Both citations are complete and correct. Exactly two PRs merged between v0.1.0 (2026-10-27T19:04Z) and v0.1.1 (2026-11-05T15:51Z): #9 (banner) and #12 (doc-drift) — so the [0.1.1] "Added" list has no gaps. The banner really is new in 0.1.1 (## Startup banner exists in skills/repoman/SKILL.md on v0.1.1, absent on v0.1.0).
  • Composes cleanly with #14 and #15: applying 14 → 15 → 16 to a clean 8a679b0 gives no conflicts.

Author: clawgenti (COLLABORATOR — maintainer)
Areas reviewed: Docs (CHANGELOG), Shell (comment only), CI
Agent/IDE config (.claude/.vscode): none
Commits: 1, signed-off: yes
CI status: 4/4 passing at 365002f

Non-blocking notes:

  • CHANGELOG.md:17 (in the section this PR edits, though outside the diff) still says "The v0.1.1 tag is cut from main after this release merges." That is now history — v0.1.1 was published 2026-11-05T15:52Z. Since you are already touching this section, worth rewording to past tense or dropping the sentence.
  • Commit subject is a bare bullet list with no conventional prefix (docs: Add set-requirements to the setup header …), advisory per the repo's commit conventions; the PR title is fine.
  • PR-body Generated by … footer → Assisted-By: Claude Code per CLAUDE.md § PR Description Attribution (template fix belongs upstream in the doc-drift fixer).

Verdict: APPROVE.

Generated by RepoMan github-pr-review@235a7f7 (https://github.com/rossoctl/agent-skills/blob/235a7f7620139ee3e4ab0872b8439591fe52e8c1/skills/github-pr-review/SKILL.md).

Comment thread CHANGELOG.md

- **doc-drift program.** The scanner and fixer compare documentation to the code at a pinned git ref (paths, flags, enumerations, retired names, versions, and absence claims) and draft Keep a Changelog notes from merged pull requests. It ships inside the `repoman` plugin and as its own marketplace plugin.
- **doc-drift program.** The scanner and fixer compare documentation to the code at a pinned git ref (paths, flags, enumerations, retired names, versions, and absence claims) and draft Keep a Changelog notes from merged pull requests. It ships inside the `repoman` plugin and as its own marketplace plugin. (#12)
- **REPOMAN banner** on interactive sessions. (#9)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: the banner is narrower than "interactive sessions" — skills/repoman/SKILL.md § Startup banner says to print it "On a human /repoman turn" and to skip it on schedule/cron, headless -p, pipeline and CI runs. Suggest: - **REPOMAN banner** on human /repoman turns. (#9)

Comment thread CHANGELOG.md
### Added

- **doc-drift program.** The scanner and fixer compare documentation to the code at a pinned git ref (paths, flags, enumerations, retired names, versions, and absence claims) and draft Keep a Changelog notes from merged pull requests. It ships inside the `repoman` plugin and as its own marketplace plugin.
- **doc-drift program.** The scanner and fixer compare documentation to the code at a pinned git ref (paths, flags, enumerations, retired names, versions, and absence claims) and draft Keep a Changelog notes from merged pull requests. It ships inside the `repoman` plugin and as its own marketplace plugin. (#12)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion: these are the first PR citations in this file — every other bullet, including the Shellcheck one two lines below, has none, so the section becomes inconsistent. If the intent is traceability, cite every entry and link it Keep-a-Changelog style (([#12](https://github.com/rossoctl/repoman/pull/12))); a bare #12 is plain text in Markdown, not a link. Otherwise drop both cites and keep the body uniform.

- Document set-requirements in repoman-setup.sh header subcommand list.
- Cite merged PRs rossoctl#12 and rossoctl#9 in the [0.1.1] changelog.

Automated update by RepoMan Doc-Drift Fixer (2026-11-05).

Signed-off-by: Clawgenti <clawgenti@users.noreply.github.com>
@clawgenti

Copy link
Copy Markdown
Collaborator Author

Superseded by #22, which combines this change with the other doc-drift fixes.

@clawgenti clawgenti closed this Nov 9, 2026
jimcadden pushed a commit that referenced this pull request Nov 9, 2026
* docs: fix release 0.1.1 date is 2026-11-05

Automated fix by RepoMan Doc-Drift Fixer (2026-11-05).

Signed-off-by: 65532 user <65532@agent-f6a74c71745da212-0.agent-f6a74c71745da212.dam-prod-agents.svc.cluster.local>
(cherry picked from commit 6c0b167)

* docs: fix release 0.1.0 date is 2026-10-27

Automated fix by RepoMan Doc-Drift Fixer (2026-11-05).

Signed-off-by: 65532 user <65532@agent-f6a74c71745da212-0.agent-f6a74c71745da212.dam-prod-agents.svc.cluster.local>
(cherry picked from commit 6b7dc3f)

* docs: doc-drift updates

- Document set-requirements in repoman-setup.sh header subcommand list.
- Cite merged PRs #12 and #9 in the [0.1.1] changelog.

Automated update by RepoMan Doc-Drift Fixer (2026-11-05).

Signed-off-by: Clawgenti <clawgenti@users.noreply.github.com>
(cherry picked from commit 32a0cef)

---------

Signed-off-by: 65532 user <65532@agent-f6a74c71745da212-0.agent-f6a74c71745da212.dam-prod-agents.svc.cluster.local>
Signed-off-by: Clawgenti <clawgenti@users.noreply.github.com>
Co-authored-by: Clawgenti <clawgenti@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc-drift Documentation drift tracked by RepoMan ready-for-ai-review Request automated AI code review from clawgenti

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants