aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

feat(governance): implement ADR-003 enforcement hooks (commit-msg, branch naming, pickup-issue skill)

Open
#186 11 comments 0 reactions 1 assignee Claimed by @scottschreckengaust View on GitHub
approved enhancement governance tooling
Dominant language
TypeScript
Stars
143
Forks
46
Avg merge
3d 9h
Merged PRs (30d)
20

Description

## Summary

Implement the progressive enforcement mechanisms defined in ADR-003's enforcement table (added in PR #144).

## Tasks

- [ ] **Commit-msg hook** (Tier 0) — Reject commits without `Refs #N` or `Fixes #N` in the message
- [ ] **Branch naming validation** (pre-push) — Validate branches match `(feat|fix|chore|docs)/-*`
- [ ] **`pickup-issue` skill** (Claude Code plugin) — Agent must invoke before implementation; hard-fails without valid issue
- [ ] **Decompose ADR-003** into Guide + Skills (Phase 2 of ADR-012 migration plan)

## Context

These were identified as "follow-up work after PR #144 merges" in that PR's comment thread. ADR-003 documents the enforcement table; this issue tracks the implementation.

## References

- ADR-003 §Enforcement mechanisms (docs/decisions/003-contribution-governance.md)
- ADR-012 §Layer 3 — executable skills
- PR #144 comment (follow-up work list)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.