Skip to content

chore(agent-guidance): add guidance-building skill#9

Merged
BenSheridanEdwards merged 2 commits into
mainfrom
codex/chore/agent-guidance-skill
Jun 29, 2026
Merged

chore(agent-guidance): add guidance-building skill#9
BenSheridanEdwards merged 2 commits into
mainfrom
codex/chore/agent-guidance-skill

Conversation

@BenSheridanEdwards

@BenSheridanEdwards BenSheridanEdwards commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Why

AgenticProjectTemplate needs a reusable way to build and maintain agent-facing repo guidance, not just a finished example of AGENTS.md and CLAUDE.md. This adds the layer model and skill that future agents can use when installing or improving guidance in other repos.

What Changed

  • Added .agents/project/AGENTIC_INFRASTRUCTURE.md to define the layers for entry contracts, tool adapters, project context, decisions, templates, local gates, remote gates, and skills.
  • Added .claude/skills/build-agent-guidance to guide agents through evidence-first updates to AGENTS.md, CLAUDE.md, and .agents/.
  • Linked the new layer model and skill from AGENTS.md, CLAUDE.md, .agents/README.md, and README.md.

Proof

  • python3 /Users/agents/.codex/skills/.system/skill-creator/scripts/quick_validate.py .claude/skills/build-agent-guidance
  • pnpm check
  • pnpm verify
  • pnpm e2e
  • Visual proof attached or linked, or N/A with reason: N/A — docs and skill-only change; no UI/CSS surface changed.
  • StyleProof reviewed, or N/A with reason: N/A — StyleProof passed with No visual changes.
  • Other proof: pre-commit hook passed typecheck, staged Biome, Fallow, and gitleaks; pre-push hook passed coverage, build, and E2E.

CI Status

  • Latest-sha GitHub Actions are green.
  • Pending checks are named below.
  • Failing checks are named below with the fix plan.

Latest-sha checks are green: CI quality, Fallow, unit/component tests, production build, E2E behaviour map, security audit, CodeQL, Lighthouse, computed-style visual gate, and StyleProof.

Risk And Rollback

Low risk. This adds documentation and a repo-local skill; it does not change runtime code or gate behavior. Rollback is reverting the single commit if the layer model or skill shape needs to be split differently.

Definition Of Done

  • Behaviour is covered by the E2E map when user-visible behaviour changed. (N/A — no product behaviour changed.)
  • Logic is unit-tested where logic changed. (N/A — no runtime logic changed.)
  • Accessibility was considered and verified for interactive/UI changes. (N/A — no UI changed; existing Playwright axe scan passed.)
  • The diff follows .agents/project/ARCHITECTURE.md and CONVENTIONS.md.
  • Any new architectural decision is recorded as an ADR. (N/A — this documents the current infrastructure layer model, no runtime architecture change.)
  • No gates were bypassed or weakened.

@github-actions

Copy link
Copy Markdown

Fallow audit report

Found 1 finding.

Details
Severity Rule Location Description
minor fallow/unused-dev-dependency package.json:44 Package '@lhci/cli' is in devDependencies but never imported

Generated by fallow.

@github-actions

Copy link
Copy Markdown

Fallow audit report

0 inline findings selected for GitHub review.

…dance-skill

# Conflicts:
#	CLAUDE.md
#	README.md
@github-actions

Copy link
Copy Markdown

🗺️ StyleProof report

✓ No visual changes detected.

@BenSheridanEdwards BenSheridanEdwards merged commit d435676 into main Jun 29, 2026
11 checks passed
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.

1 participant