Skip to content

chore(meta): establish LLM management foundation#416

Merged
ss-o merged 3 commits into
mainfrom
feature-410
May 20, 2026
Merged

chore(meta): establish LLM management foundation#416
ss-o merged 3 commits into
mainfrom
feature-410

Conversation

@ss-o
Copy link
Copy Markdown
Member

@ss-o ss-o commented May 20, 2026

Summary

  • add canonical org-wide AI agent instructions, patterns, ADRs, and operational runbooks
  • normalize the org label taxonomy and update issue templates/Renovate/workflows to use canonical labels
  • document safe label cleanup and tracker usage for meta:org-tracked
  • tighten workflow hygiene for touched/shared workflows and restore the configured Trunk hook target

GitHub/Tracker updates

Validation

Closes #410
Refs #411, #412, #413, #414, #415

@ss-o ss-o force-pushed the feature-410 branch 2 times, most recently from 2803080 to 794e0bc Compare May 20, 2026 04:41
@ss-o ss-o self-assigned this May 20, 2026
@ss-o ss-o marked this pull request as ready for review May 20, 2026 04:49
@ss-o ss-o requested a review from a team as a code owner May 20, 2026 04:49
Copilot AI review requested due to automatic review settings May 20, 2026 04:50
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Establishes a foundation in z-shell/.github for org-wide LLM/agent operations (instructions, patterns, ADRs, runbooks) while normalizing the canonical label taxonomy and updating templates/workflows to align with it.

Changes:

  • Add canonical agent guidance and org knowledge structure (AGENTS.md, PATTERNS.md, decisions/, runbooks/, plus entry-point docs).
  • Normalize labels via .github/lib/labels.yml and update issue templates / Renovate / workflows to use canonical labels.
  • Tighten workflow hygiene (permissions/concurrency, action pinning) and restore the Trunk hook target.

Reviewed changes

Copilot reviewed 26 out of 26 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
runbooks/triage.md New org triage runbook using canonical labels and tracker rules.
runbooks/release.md New release coordination guidance and prompt templates.
runbooks/org-review.md New weekly org-review workflow/runbook and prompt template.
runbooks/labels.md Label maintenance runbook documenting canonical groups and safe cleanup order.
runbooks/adr.md ADR drafting runbook with a “draft-only / PROPOSED first” workflow.
renovate-config.json Switch Renovate PR labels to canonical type/area labels.
PATTERNS.md New cross-repo implementation idioms (plugin skeleton, fpath guards, unload function).
decisions/0001-meta-repo-and-agents-md.md ADR proposing the meta-repo structure centered on AGENTS.md.
decisions/0002-zi-as-canonical-plugin-manager.md ADR proposing zi as the canonical plugin manager.
decisions/0003-conventional-commits.md ADR proposing Conventional Commits org-wide + selective release automation.
CLAUDE.md Claude entry point that defers to AGENTS.md and .github/AGENT_MEMORY.md.
AGENTS.md Canonical org-wide agent instructions and cross-repo workflow pointers.
.github/workflows/zsh-n.yml Add explicit permissions/concurrency and pin checkout action.
.github/workflows/stars.yml Add explicit permissions/concurrency and switch to local ./actions/commit.
.github/workflows/lychee.yml Update issue label to canonical type:maintenance.
.github/workflows/dependency-review.yml Change trigger set to reusable-only (workflow_call).
.github/README.md Document new org knowledge structure and update shared assets listing.
.github/lib/labels.yml Replace legacy labels with canonical type/area/status/priority taxonomy (plus meta:org-tracked).
.github/ISSUE_TEMPLATE/01_bug_report.yml Update default labels to canonical type:bug + status:triage.
.github/ISSUE_TEMPLATE/02_feature_request.yml Update default label to canonical type:feature.
.github/ISSUE_TEMPLATE/03_codebase_improvement.yml Update default label to canonical type:maintenance.
.github/ISSUE_TEMPLATE/04_documentation.yml Update default labels to canonical type:docs + area:docs.
.github/ISSUE_TEMPLATE/05_membership.yml Update default labels to canonical type:membership + area:meta.
.github/ISSUE_TEMPLATE/06_agent_handoff.yml Update default labels to canonical type:handoff + area:meta.
.github/hook.sh Restore Trunk hook target script for trunk check.
.github/copilot-instructions.md Add Copilot entry point deferring to canonical AGENTS.md + handoff doc.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .github/workflows/dependency-review.yml
Comment thread .github/ISSUE_TEMPLATE/05_membership.yml Outdated
Comment thread runbooks/release.md Outdated
ss-o and others added 2 commits May 20, 2026 06:15
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Sall <59910950+ss-o@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Sall <59910950+ss-o@users.noreply.github.com>
@ss-o ss-o merged commit 62b432b into main May 20, 2026
3 checks passed
@ss-o ss-o deleted the feature-410 branch May 20, 2026 05:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Establish LLM management foundation in the meta-repo

2 participants