Use when conducting, reviewing, or planning the annual planning session
Facilitate the EOS Annual Planning session — the formal year-end process (typically a 2-day offsite) where the leadership team refreshes the V/TO, reviews the outgoing year, sets the new 1-Year Plan, and establishes Q1 Rocks. This is the most comprehensive EOS meeting of the year.
Search upward from the current directory for the .ceos marker file. This file marks the root of the CEOS repository.
If .ceos is not found, stop and tell the user: "Not in a CEOS repository. Clone your CEOS repo and run setup.sh first."
Sync before use: Once you find the CEOS root, run to get the latest data from teammates. If it fails (conflict or offline), continue silently with local data.
git -C <ceos_root> pull --ff-only --quiet 2>/dev/null| File | Purpose |
|---|---|
data/annual/YYYY-planning.md | Annual planning session notes (one per year) |
data/vision.md | V/TO document (read and update during V/TO Refresh) |
data/rocks/YYYY-QN/ | Rock files by quarter (read for year-in-review scoring) |
data/scorecard/weeks/ | Weekly scorecard data (read for trend analysis) |
data/scorecard/metrics.md | Scorecard metric definitions (reference for updates) |
data/issues/open/ | Open issues (read for issues sweep) |
data/issues/solved/ | Solved issues (count for year summary) |
data/accountability.md | Accountability Chart (read for org checkup) |
data/people/ | People Analyzer evaluations (read for org checkup) |
templates/annual-planning.md | Template for new annual planning files |
The full annual planning session follows a 7-section agenda:
| # | Section | Focus |
|---|---|---|
| 1 | Year in Review | Score Q4 Rocks, review annual Scorecard trends, celebrate wins |
| 2 | V/TO Refresh | Update 3-Year Picture, set new 1-Year Plan with measurable goals |
| 3 | Issues Sweep | Clear the long-term issues list via IDS |
| 4 | Organizational Checkup | Review Accountability Chart, run People Analyzer |
| 5 | Set Q1 Rocks | First quarter's Rocks aligned to the new 1-Year Plan |
| 6 | Set Scorecard | Review and update weekly measurables for the new year |
| 7 | Conclude | Key decisions, cascading messages, next steps |
When determining the planning year:
Use when conducting the full annual planning session with the structured 7-section agenda.
Determine the planning year. Ask if not clear from context. Follow the Year Determination rules above.
Check for existing planning file. Look for data/annual/YYYY-planning.md.
Gather session details:
Gather context. Read these files silently:
data/vision.md — current V/TO statedata/rocks/ — all quarters for the outgoing yeardata/scorecard/weeks/ — scorecard data for the yeardata/issues/open/ — open issues listdata/accountability.md — current org structuredata/people/ — People Analyzer evaluationsCreate the year directory if it doesn't exist: data/annual/
Display a preparation summary:
Annual Planning — [Year]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Date: [Date]
Attendees: [Names]
Location: [Location]
Data loaded:
V/TO: [Last updated date]
Rocks: [Count] across [N] quarters
Scorecard: [N] weeks of data
Open issues: [Count]
People evaluations: [Count]
Let's walk through the 7-section agenda.
Score Q4 Rocks. Read all Rocks from data/rocks/YYYY-Q4/. Display current status for each Rock. For any Rocks still on_track or off_track, ask: "Complete or incomplete?" Update status to complete or dropped.
Calculate Q4 completion rate: (complete / total) * 100.
If no Q4 Rock files exist: "No Q4 Rocks on file. Skip Q4 scoring, or enter scores manually?"
Annual Rock Summary. Read Rocks from all four quarters of the outgoing year. Display a summary table:
Annual Rock Summary — YYYY
━━━━━━━━━━━━━━━━━━━━━━━━━━
| Quarter | Total | Complete | Rate |
|---------|-------|----------|------|
| Q1 | 5 | 4 | 80% |
| Q2 | 6 | 5 | 83% |
| Q3 | 5 | 3 | 60% |
| Q4 | 6 | 5 | 83% |
| Year | 22 | 17 | 77% |
If below 80% annual average: "Below the 80% target. Discuss: Were Rocks too ambitious, or were there execution issues?"
Scorecard Trends. Read scorecard files for the year. Identify which metrics consistently hit or missed goals. Display a summary of trends.
If no scorecard data exists: "No scorecard data for YYYY. Skip trends."
Celebrate Wins. Prompt: "What were the biggest wins and accomplishments this year?" Record responses.
Record all Year in Review data in the planning file.
Walk through each V/TO section from data/vision.md:
Core Values: Display current values. Ask: "Do these still resonate? Any changes?" Note: Core Values should rarely change.
Core Focus: Display purpose and niche. Ask: "Still accurate?" Note: Core Focus should rarely change.
10-Year Target: Display current target. Ask: "Still the right big goal?" Note: This shifts slowly.
3-Year Picture: Display current state. Ask: "What's changed? What should the 3-Year Picture look like now?" This section updates to reflect progress.
1-Year Plan: This is entirely new each year. Ask: "What are the 3-7 measurable goals for [next year]?" Walk through each goal, ensuring it has a specific measurable target.
Marketing Strategy: Display target market, 3 Uniques, proven process. Ask: "Any updates?"
Important: Record proposed V/TO changes in the planning file. Actual updates to data/vision.md should be done via ceos-vto after the session, or the user can approve inline updates during this step. If the user wants to update vision.md now, show the diff and ask for approval before writing.
data/issues/open/.Note: For issues that need full IDS treatment, reference ceos-ids for creating formal issue files.
Read data/accountability.md for the current Accountability Chart.
Display all seats with current owners.
Ask: "Are all seats filled with the right people? Any structural changes needed?"
If People Analyzer evaluations exist in data/people/, reference the latest ratings:
People Summary:
Brad: Core Values 5/5, GWC Pass ✓
Sarah: Core Values 4/5, GWC Pass ✓
Mike: Core Values 3/5, GWC Evaluating ⚠️
Discuss any concerns. Record structural changes and people decisions.
Note: For formal People Analyzer updates, reference ceos-people.
Note: Create individual Rock files using ceos-rocks after this session. The planning file captures the decisions; the Rock files are the operational artifacts.
data/scorecard/metrics.md (if it exists).Note: Update the Scorecard metrics file using ceos-scorecard after this session.
data/annual/YYYY-planning.md.git commit to save the planning session."ceos-vto" (if not done inline)ceos-rocks"ceos-scorecard"Use when analyzing the outgoing year's performance without running a full planning session.
Ask which year to review. Defaults:
Read all Rock files from data/rocks/YYYY-Q1/, data/rocks/YYYY-Q2/, data/rocks/YYYY-Q3/, data/rocks/YYYY-Q4/.
For each quarter, calculate:
complete)(complete / total) * 100If a quarter has no Rock files: "No Rocks on file for YYYY-QN."
Display the annual summary:
Year in Review — YYYY Rock Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Quarter | Total | Complete | Dropped | Rate |
|---------|-------|----------|---------|------|
| Q1 | 5 | 4 | 1 | 80% |
| Q2 | 6 | 5 | 1 | 83% |
| Q3 | 5 | 3 | 2 | 60% |
| Q4 | 6 | 5 | 1 | 83% |
| Year | 22 | 17 | 5 | 77% |
Annual target: 80%+
Also display per-person breakdown:
By Owner:
Brad: 8 Rocks, 6 complete (75%)
Daniel: 7 Rocks, 6 complete (86%)
Sarah: 7 Rocks, 5 complete (71%)
Read all scorecard files from data/scorecard/weeks/ that fall within the year.
For each metric, calculate:
Display summary:
Scorecard Trends — YYYY
━━━━━━━━━━━━━━━━━━━━━━━
| Metric | Avg | Goal | Hit Rate | Trend |
|-----------------|-------|-------|----------|-----------|
| Weekly Revenue | $48K | $50K | 65% | Improving |
| New Customers | 8 | 10 | 45% | Stable |
| NPS | 74 | 70 | 85% | Improving |
If no scorecard data: "No scorecard data for YYYY."
Count solved issues from data/issues/solved/ with dates within the year. Also count current open issues.
Issues — YYYY
━━━━━━━━━━━━━
Resolved: 23 issues
Open: 8 issues remaining
Display a consolidated year report:
Year Summary — YYYY
━━━━━━━━━━━━━━━━━━━
Rock Completion: 77% (target 80%)
Scorecard Hit Rate: 65% average across metrics
Issues Resolved: 23
Issues Remaining: 8
Highlights:
✓ [Strongest quarter for Rocks]
✓ [Best-performing Scorecard metric]
⚠️ [Area needing improvement]
Ask: "Would you like to save this review to data/annual/YYYY-planning.md?"
Use when walking through V/TO sections for annual updates without the full planning session.
Read data/vision.md. If the file doesn't exist: "No V/TO found. Run setup.sh init first, or create one with ceos-vto."
Display a summary of the current V/TO state:
V/TO Status — Last updated: YYYY-MM-DD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Section | Status |
|---------------------|---------------------------------|
| Core Values | [Count] values defined |
| Core Focus | [Purpose + Niche summary] |
| 10-Year Target | [Target summary] |
| 3-Year Picture | [Key points] |
| 1-Year Plan | [Goal count] goals |
| Marketing Strategy | [Target market summary] |
Ask: "Which V/TO sections do you want to refresh?"
Options:
For each section:
After all sections are reviewed:
data/vision.md?"git commit to save the V/TO updates."After V/TO is refreshed, offer:
Plan: Progressive display of each agenda section during the session. Show the complete planning file before saving.
Review Year: Summary tables with Rock completion rates (per quarter and per person), Scorecard trends, and issues count. Offer to save the review.
Refresh V/TO: Section-by-section display with diffs for any changes. Summary of all changes before writing.
ceos-vto, ceos-rocks, ceos-scorecard, ceos-ids, and ceos-people as follow-up tools, but let the user decide when to use them.data/accountability.md, note it: "Some leadership team members may be missing from the attendee list."data/vision.md (in Plan mode step 3 or Refresh V/TO mode), always show before/after for each section and get approval.ceos-annual reads data/vision.md for the current V/TO state and may update it during the V/TO Refresh section (Section 2). Inline updates to data/vision.md are allowed with user approval; alternatively, formal updates can be deferred to ceos-vto after the session.ceos-annual reads Rock files from all quarters for the year-in-review scoring and creates Q1 Rock decisions during Section 5. Formal Rock file creation should be done via ceos-rocks after the session.ceos-annual reads scorecard data from data/scorecard/weeks/ for trend analysis during the Year in Review (Section 1). Scorecard metric updates (Section 6) are recorded in the planning file; formal updates to data/scorecard/metrics.md should be done via ceos-scorecard.ceos-annual reads People Analyzer evaluations from data/people/ during the Organizational Checkup (Section 4). Formal People Analyzer updates should be done via ceos-people.ceos-annual reads data/accountability.md during the Organizational Checkup (Section 4) to review the org structure and identify empty or misaligned seats.ceos-annual reads open issues from data/issues/open/ and solved issues from data/issues/solved/ during the Issues Sweep (Section 3). Formal issue creation and resolution should be done via ceos-ids.ceos-annual is the most comprehensive orchestrator — it reads data from nearly all other skills during the planning session. The annual planning file at data/annual/YYYY-planning.md captures decisions; individual skills handle the operational artifacts (Rock files, scorecard updates, V/TO changes, etc.).