[LLM] Organize PR provenance documentation #3

Merged

blizzardfinnegan merged 9 commits from blizzardfinnegan/agents-pr-docs-policy into main 2026-11-04 09:08:23 -07:00 AGit

Conversation 0 Commits 9 Files changed 6 +141 -12

blizzardfinnegan commented 2026-11-03 15:32:03 -07:00

Owner

• Copy link
• Copy Markdown

Goal

Modify AGENTS.md so every new PR has an organized docs directory, repository-level provenance logs are only committed on main, all PRs target main, and pure-offline log needs use a separate main-targeting PR linked from the pure-offline PR.

Target iteration

Iteration 1 of 5

Changes

• Added unique docs/main/<PR_SLUG>/ directory requirements per PR.
• Clarified that feature branches and pure-offline contain no repository-level logs.
• Required provenance PRs to target main.
• Added the second main-targeting PR and link workflow for pure-offline log needs.
• Added matching validator checks and per-PR/non-log branch placeholders.

Validation

• AGENTS_POLICY_OK branch=llm/agents-pr-docs-policy
• POLICY_DOCS_LAYOUT=OK
• POLICY_STATIC_VALIDATION=OK
• Syntax, git diff --check, and ShellCheck passed.

Blockers

None for the local policy implementation.

## Goal Modify `AGENTS.md` so every new PR has an organized docs directory, repository-level provenance logs are only committed on `main`, all PRs target `main`, and pure-offline log needs use a separate main-targeting PR linked from the pure-offline PR. ## Target iteration Iteration 1 of 5 ## Changes - Added unique `docs/main/<PR_SLUG>/` directory requirements per PR. - Clarified that feature branches and `pure-offline` contain no repository-level logs. - Required provenance PRs to target `main`. - Added the second main-targeting PR and link workflow for pure-offline log needs. - Added matching validator checks and per-PR/non-log branch placeholders. ## Validation - `AGENTS_POLICY_OK branch=llm/agents-pr-docs-policy` - `POLICY_DOCS_LAYOUT=OK` - `POLICY_STATIC_VALIDATION=OK` - Syntax, `git diff --check`, and ShellCheck passed. ## Blockers None for the local policy implementation.

blizzardfinnegan added 1 commit 2026-11-03 15:32:03 -07:00

[LLM] Define PR provenance directories ... fb134603ce

Goal: Modify AGENTS.md to require a new documentation directory per PR, keep repository-level provenance logs only on main, require PRs to target main, and use a second main-targeting PR linked from pure-offline PRs when pure-offline logs are needed.

Target iteration: Iteration 1 of 5

Added PR_SLUG documentation-directory policy, main-only log placement, pure-offline second-PR/link instructions, matching validator checks, and required non-log placeholders.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-03 15:32:36 -07:00

[LLM] Add PR provenance checklist ... c3f0f02156

Goal: Continue the AGENTS.md provenance organization objective by organizing logs per PR, keeping repository-level logs only on main, targeting main with PRs, and linking a second main PR when pure-offline logs are needed.

Target iteration: Iteration 2 of 5

Added a non-log per-PR provenance checklist under docs/main/agents-pr-docs-policy with target-main, [LLM], main-only log, and pure-offline linked-PR checks.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-03 15:33:05 -07:00

[LLM] Enforce main-only provenance logs ... 62f02fa122

Goal: Continue the AGENTS.md provenance organization objective by requiring a docs directory per PR, keeping repository logs only on main, targeting main with PRs, and linking a second main PR for pure-offline log needs.

Target iteration: Iteration 3 of 5

Updated the policy validator to verify PR_SLUG documentation directories and reject repository-level .log files introduced by non-main branches; documented PR_SLUG validation in AGENTS.md.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-03 15:33:53 -07:00

[LLM] Test non-main log rejection ... ea340941f1

Goal: Continue the AGENTS.md provenance organization objective by requiring PR-specific docs directories, main-only repository logs, main-targeting PRs, and linked second main PRs for pure-offline log needs.

Target iteration: Iteration 4 of 5

Added tests/test-agents-policy.sh to verify an allowed PR slug and reject a committed repository log introduced on an isolated non-main branch.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-03 15:34:18 -07:00

[LLM] Document policy test execution ... ccbee63075

Goal: Complete the AGENTS.md provenance organization objective by requiring per-PR documentation directories, main-only repository logs, main-targeting PRs, and linked second main PRs for pure-offline log needs.

Target iteration: Iteration 5 of 5

Documented the positive and negative policy test commands in AGENTS.md and completed the final policy audit.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-04 09:03:39 -07:00

[LLM] Require fetch before Git actions ... 3bbe45e283

Goal: Update AGENTS.md to require agents to call git fetch before any other Git action so remote information is current.

Target iteration: Iteration 1 of 1

Added the git-fetch-first rule for all repository, branch, commit, rebase, push, and PR-ref operations, including relevant remote guidance.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-04 09:03:58 -07:00

[LLM] Align policy commit metadata ... 8bf8ca3a7d

Goal: Ensure the AGENTS.md git-fetch-first policy update complies with repository-local author metadata.

Target iteration: Iteration 1 of 1

Metadata-only follow-up; no additional file changes.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan force-pushed blizzardfinnegan/agents-pr-docs-policy from 8bf8ca3a7d to 95c3b70145 2026-11-04 09:04:19 -07:00 Compare

blizzardfinnegan added 1 commit 2026-11-04 09:04:59 -07:00

[LLM] Use fetched main for log validation ... 9a542f4d25

Goal: Ensure the AGENTS.md fetch-first policy validator compares non-main branch logs against the current origin/main ref.

Target iteration: Iteration 1 of 1

Prefer origin/main after fetch, with local main as fallback, so stale local refs cannot produce false log-placement failures.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan added 1 commit 2026-11-04 09:05:15 -07:00

[LLM] Verify fetched-policy metadata ... 1d0f95827a

Goal: Keep the fetch-first AGENTS.md policy branch metadata compliant after rebasing onto origin/main.

Target iteration: Iteration 1 of 1

Metadata-only follow-up; no file changes.

Model: GPT-5.6-Luna (Kiro via kiro-cli; provider=unknown; runtime=kiro-cli chat; agent=Kiro; session=unknown)

blizzardfinnegan merged commit 9cebe5c113 into main 2026-11-04 09:08:23 -07:00

blizzardfinnegan referenced this pull request from a commit 2026-11-04 09:08:24 -07:00

[LLM] Organize PR provenance documentation (#3)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

blizzardfinnegan/dotfiles!3

No description provided.