alignment-values-north-star
Alignment: Values & North Star
Table of Contents
The framework has three layers: North Star (aspirational direction), Values/Guardrails (core operating principles), and Decision Tenets/Behaviors (concrete, observable demonstrations of values).
Quick Example:
# Engineering Team Alignment
## North Star
Build systems that developers love to use and operators trust to run.
## Values
- **Simplicity**: Choose boring technology that works over exciting technology that might
- **Reliability**: Every service has SLOs and we honor them
- **Empathy**: Design for the developer experience, not just system performance
## Decision Tenets
When choosing between options:
✓ Pick the solution with fewer moving parts
✓ Choose managed services over self-hosted when quality is comparable
✓ Optimize for debuggability over micro-optimizations
✓ Document decisions (ADRs) for future context
## Behaviors (What This Looks Like)
- Code reviews comment on operational complexity, not just correctness
- We say no to features that compromise reliability
- Postmortems focus on learning, not blame
- Documentation is part of "done"
Workflow
Copy this checklist and track your progress:
Alignment Framework Progress:
- [ ] Step 1: Understand context
- [ ] Step 2: Choose framework
- [ ] Step 3: Develop alignment artifact
- [ ] Step 4: Validate quality
- [ ] Step 5: Deliver and socialize
Step 1: Understand context
Gather background: team/organization (size, stage, structure), current situation (new team, scaling, misalignment, crisis), trigger (why alignment needed NOW), stakeholders (who needs to align), hard decisions (where misalignment shows up), and existing artifacts (mission, values, culture statements). This ensures the framework addresses real needs.
Step 2: Choose framework
For new teams/startups (< 30 people, defining identity from scratch) → Use resources/template.md. For scaling organizations (existing values need refinement, multiple teams, need decision framework) → Study resources/methodology.md. To see examples → Review resources/examples/ (engineering-team.md, product-vision.md, company-values.md).
Step 3: Develop alignment artifact
Create alignment-values-north-star.md with: compelling North Star (1-2 sentences, aspirational but specific), 3-5 core values (specific to this team, not generic), decision tenets ("When X vs Y, we..."), observable behaviors (concrete examples), anti-patterns (optional - what we DON'T do), and context (optional - why these values). See Common Patterns for team-type specific guidance.
Step 4: Validate quality
Self-check using resources/evaluators/rubric_alignment_values_north_star.json. Verify: North Star is inspiring yet concrete, values are specific and distinctive, decision tenets guide real decisions, behaviors are observable/measurable, usable for decisions TODAY, trade-offs acknowledged, no contradictions, distinguishes this team from others. Minimum standard: Score ≥ 3.5 (aim for 4.5+ if organization-wide).
Step 5: Deliver and socialize
Present completed framework with rationale (why these values), examples of application in decisions, rollout/socialization approach (hiring, decision-making, onboarding, team meetings), and review cadence (typically annually). Ensure team can recall and apply key points.
Common Patterns
For technical teams:
- Focus on technical trade-offs (simplicity vs performance, speed vs quality)
- Make architectural principles explicit
- Include operational considerations
- Address technical debt philosophy
For product teams:
- Center on user/customer value
- Address feature prioritization philosophy
- Include quality bar and launch criteria
- Make product-market fit assumptions explicit
For company-wide values:
- Keep values aspirational but grounded
- Include specific behaviors (not just values)
- Address how values interact (what wins when they conflict?)
- Make hiring/firing implications clear
For crisis/change:
- Acknowledge what's changing
- Re-center on core that remains
- Be explicit about new priorities
- Include timeline for transition
Guardrails
Do:
- Make values specific and distinctive (not generic)
- Include concrete behaviors and examples
- Acknowledge trade-offs (what you're NOT optimizing for)
- Test values against real decisions
- Keep it concise (1-2 pages max)
- Make it memorable (people should be able to recall key points)
- Involve the team in creating it (not top-down)
Don't:
- Use corporate jargon or buzzwords
- Make it so generic it could apply to any company
- Create laundry list of every good quality
- Ignore tensions between values
- Make it purely aspirational (need concrete behaviors)
- Set it and forget it (values should evolve)
- Weaponize values to shut down dissent
Quick Reference
- Standard template:
resources/template.md - Scaling/complex cases:
resources/methodology.md - Examples:
resources/examples/engineering-team.md,resources/examples/product-vision.md,resources/examples/company-values.md - Quality rubric:
resources/evaluators/rubric_alignment_values_north_star.json
Output naming: alignment-values-north-star.md or {team-name}-alignment.md