Files
2025-11-30 08:43:48 +08:00

4.3 KiB
Raw Permalink Blame History

name, description, version, triggers
name description version triggers
wolf-governance Wolf's governance framework, compliance rules, quality gates, and process standards (condensed index) 1.2.0
governance
compliance
quality gates

Wolf Governance Index

Quick reference for governance requirements. For detailed examples, process flows, and emergency procedures, use the Skill tool to load wolf-governance SKILL.md.

The Four Pillars (Canon Charter)

All governance decisions evaluated against:

  1. Portability 🔄 - Cross-environment compatibility, platform independence
  2. Reproducibility 🔁 - Consistent outcomes, predictable behavior
  3. Safety 🛡️ - Risk mitigation, secure operations, fail-safe mechanisms
  4. Research Value 🔬 - Scientific methodology, evidence-based decisions

Authority Structure

Code Reviewers → Final merge authority, architectural decisions
PM Agents → Requirements authority, prioritization, release sign-off
Specialist Roles → Domain expertise, advisory input, escalation triggers
Implementers → Cannot merge own PRs, cannot bypass gates

MANDATORY: No agent can approve their own work


Definition of Done (DoD)

MUST Have (Blocking )

  • All tests passing (Fast-Lane + Full-Suite)
  • Code review approved (by different agent)
  • Documentation updated (README, API docs, CHANGELOG)
  • Journal entry created (YYYY-MM-DD-task-slug.md)
  • CI/CD checks green

SHOULD Have (Strong Recommendation ⚠️)

  • 📊 Performance benchmarks met
  • 🔒 Security scan clean
  • Accessibility validated (if UI work)
  • 📈 Metrics improved or maintained

MAY Have (Optional )

  • 🎨 UI/UX review
  • 🌍 Internationalization
  • 📱 Mobile testing

Two-Tier Test Pipeline

Fast-Lane (5-10 min) - Required for PR Creation

  • Linting: Max 5 errors allowed
  • Unit tests: 60% coverage minimum
  • Critical integration tests pass
  • Security: 0 critical, ≤5 high vulnerabilities
  • Smoke tests: Core services start

Full-Suite (30-60 min) - Required for Merge

  • E2E tests: 90% success rate
  • Performance: Score ≥70/100
  • Security: Score ≥80/100
  • Cross-platform: Node 18/20/21 compatible
  • Migration: Rollback procedures tested

Archetype-Specific Gates

product-implementer:

  • AC met , Tests pass , Docs updated

security-hardener:

  • Threat model , Security scan , Pen test

perf-optimizer:

  • Baseline metrics , Post-change metrics , Budgets met

reliability-fixer:

  • Root cause documented , Regression test , Monitoring added

research-prototyper:

  • Findings documented , Recommendations , Risks identified

(Full archetype gates in SKILL.md)


Quick Compliance Check

Before requesting review:

  • Can I answer "yes" to all 5 MUST-haves?
  • Did Fast-Lane pass? (tests, linting, security)
  • Did someone else review my work? (not self-approved)
  • Does my journal entry exist?
  • Are CI checks green?

If any "no" → Not ready for merge


Emergency Procedures

When blocked by failing gate:

  1. Fix the issue (preferred)
  2. Escalate to PM for priority decision
  3. Document reason in journal
  4. Never bypass without approval

When gates conflict:

  1. Security gates override all others
  2. Safety gates override performance
  3. Evidence gates override speed

Process Requirements

Phase Lifecycle

All work follows: Planning → Implementation → Review → Merge

Artifact Requirements

  • Code: GitHub PR with descriptive title
  • Docs: README, API docs, inline comments
  • Journal: Problems, decisions, learnings
  • Tests: Unit, integration, E2E coverage

Review Requirements

  • At least 1 approval from code-reviewer
  • Address all comments or document why not
  • Re-request review after changes
  • Pass all CI checks before merge

Next Steps

REQUIRED NEXT SKILL: Load wolf-roles

  • Why: Governance defines WHAT must be done. Roles define WHO does it and HOW.
  • Gate: Cannot execute governance without understanding role boundaries
  • Tool: Use Skill tool to load wolf-roles

Sequential Skill Chain:

  1. Principles (loaded)
  2. Archetypes (loaded)
  3. Governance (you are here)
  4. → Load wolf-roles for role-specific guidance

This is a condensed index (~600 tokens). For full content (~4,500 tokens), load SKILL.md.