Skip to content

chore: add agentic coding quality gates#15

Open
deferredreward wants to merge 4 commits intounfoldingWord:mainfrom
deferredreward:chore/agentic-coding-quality-gates
Open

chore: add agentic coding quality gates#15
deferredreward wants to merge 4 commits intounfoldingWord:mainfrom
deferredreward:chore/agentic-coding-quality-gates

Conversation

@deferredreward
Copy link
Copy Markdown

Summary

  • Replaced bypassPermissions with explicit tool allowlists in .claude/settings.json — Claude can now only run approved commands instead of having unrestricted access
  • Expanded CLAUDE.md from a minimal 12-line file to full guardrail coverage — adds push rules, deploy rules, merge rules, commit rules, verification workflow, post-push workflow, and PR review handling
  • Added gitleaks secret scanning and npm dependency audit to the .husky/pre-commit hook so secrets and vulnerable dependencies are caught before code leaves the developer's machine
  • Added a gitleaks secret-scan job to .github/workflows/ci.yml as a CI safety net

Why

We audited current best practices for agentic coding (March 2026) and found significant gaps in web-client specifically:

  • It had bypassPermissions enabled, meaning Claude could run any command without restriction
  • Its CLAUDE.md contained almost no guardrails (just 12 lines about streaming animation)
  • There was no secret scanning in the commit pipeline
  • There was no dependency auditing in the commit pipeline

These changes bring web-client to parity with the guardrails already in place for worker and admin-portal.

Test plan

  • Verify pre-commit hook runs gitleaks and npm audit on commit
  • Verify CI secret-scan job passes on a clean branch
  • Confirm Claude respects the new allowlists in .claude/settings.json
  • Review expanded CLAUDE.md rules for completeness

🤖 Generated with Claude Code

claude and others added 4 commits March 11, 2026 11:53
- Replace bypassPermissions with explicit tool allowlists in
  .claude/settings.json so Claude can only run approved commands
- Expand CLAUDE.md from minimal 12-line file to full guardrail coverage
  (push rules, deploy rules, merge rules, commit rules, verification
  workflow, post-push workflow, PR review handling)
- Add gitleaks secret scanning and npm dependency audit to pre-commit hook
- Add gitleaks secret-scan job to CI workflow

Brings web-client to parity with worker and admin-portal.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gitleaks-action@v2 requires a paid GITLEAKS_LICENSE for org repos.
Local pre-commit hook handles secret scanning without a license.
- Add || exit 1 after gitleaks commands so secret detection actually
  prevents the commit from proceeding
- Remove npm audit from pre-commit — transitive deps with no available
  fix can lock out all devs. CI already runs this check.
- Remove .claude/settings.json from version control (already in .gitignore)
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.

2 participants