Weekly Planning Skill | Agent Skills

Weekly Planning

Overview

Turn retro findings + existing backlog into a prioritized week with clear outcomes, issues in correct repos, and delegation matrix (founder vs agent).

When to Use

After weekly retro is complete
Monday/Tuesday when planning the week
When user says "план на неделю", "приоритизация", "что делаем"

Iron Rule: Planning Is Not Execution

Weekly planning creates a plan. It does not execute the plan.

Allowed during planning:

Gather context needed to choose outcomes
Read calendars, issues, project boards, CRM/backlog files, and recent notes
Draft outcomes, issue proposals, and board updates

Not allowed during planning:

Start implementation work for a chosen outcome
Create deliverables, briefs, proposals, content, code, or production changes
Spawn executor agents for work that belongs to the coming week

If the user asks to "do this now" while planning, finish or pause planning first, then handle that as a separate execution task.

Process

digraph planning {
  rankdir=TB;
  node [shape=box];

  collect [label="1. Collect all tasks"];
  calendar [label="2. Map calendar"];
  group [label="3. Group by surface"];
  eisenhower [label="4. Eisenhower split"];
  outcomes [label="5. Choose outcomes"];
  issues [label="6. Create issues\nin correct repos"];
  board [label="7. Add to board\nwith W{NN} label"];
  page [label="8. Create living\nweekly plan"];

  collect -> calendar -> group -> eisenhower -> outcomes -> issues -> board -> page;
}

1. Collect all tasks

Sources to scan:

Retro backlog (label retro:W{NN-1})
Open issues across ALL repos: gh search issues --owner $YOUR_OWNER --state open
GitHub Projects for active initiatives
Calendar events (meetings, lectures, mentoring)
User input (new tasks from interview)

2. Map calendar

Read known sources before asking the user. Use calendar, existing issues, project boards, and planning files to establish:

Today's date
Planned week start/end
Fixed events
Known deadlines
Available capacity

Ask only for facts that are not recoverable from sources, one question at a time.

IMPORTANT: Verify dates before writing outcomes. Do not create deadlines in the past. If the deadline is today, include a time boundary such as "by EOD".

3. Group by surface

Group tasks by where work happens. Use the repos and task routing defined in AGENTS.md / CLAUDE.md config (set up by corp-init).

Example surfaces:

| Surface | Description | |---------|-------------| | Product delivery | Main product/service repos | | Sales/pipeline | CRM, sales tooling | | Content | Blog, videos, social media | | Strategy | Planning, cross-cutting decisions | | Infrastructure | Internal tools, automation |

4. Eisenhower split with delegation

For each task, classify:

| | Urgent | Not Urgent | |---|--------|-----------| | Important | Founder does TODAY | Founder schedules this week | | Not Important | Agent does async | Parking lot / drop |

Key question per task: "Does this require founder judgment, or can an agent execute it from the issue description?"

5. Choose outcomes

Outcomes = results, not tasks. Format: "By Friday, X is true."

Rules:

NOT limited to 3 — as many as realistic
Each outcome has a measurable check
Include both founder-only and agent-delegated work
Include B2B/sales if there are active deals — these are outcomes, not bonuses
Outcomes are commitments chosen with the user, not a silent reconstruction from the backlog
Use the backlog as input, then ask the user to choose or edit outcome options

Example:

Outcome: New feature launched
Check: deployed to production, 0 critical bugs by Friday
Founder: final UX decisions, announcement copy
Agent: implementation, tests, deploy script

6. Create issues in CORRECT repos

CRITICAL: Issue lives where the work happens. Use the task routing from your CLAUDE.md config.

Issue about backend bug → backend repo
Issue about marketing → marketing repo
Issue about content → content repo
Issue about strategy → main planning repo

Before creating any issue:

VERIFY current state (check existing issues, files, data)
PROPOSE to user
CREATE only after verification

Label every issue: W{NN} + optionally retro:W{NN-1} if from retro.

7. Add to unified board

All W{NN} issues → your GitHub Project (from CLAUDE.md config: project_id and owner).

Create or use view "W{NN}" filtered by label.

# Add to project (use project_id and owner from your config)
gh project item-add $PROJECT_ID --owner $YOUR_OWNER --url $ISSUE_URL

# Verify
gh search issues --owner $YOUR_OWNER --label "W{NN}" --state open

8. Create the living weekly plan

Resolve the ISO week from the current local date. Never hardcode W34 or copy the previous filename.

python3 skills/weekly-planning/scripts/living_week.py context --workspace . --json
python3 skills/weekly-planning/scripts/living_week.py create --workspace .

The generator creates reports/WNN-plan.html. Before presenting it:

Remove every element with data-placeholder="true".
Populate all seven day columns with accepted work; every task card has one data-area.
Keep exactly one pair of daily:updated, daily:kanban, and hidden daily:day-slice markers. The local daily skill may replace only these marked regions.
Mark past days as closed with the tasks and facts that actually happened. Highlight the current day. Keep future days as plan.
Configure the three display time zones and the seven work Areas in the page script. Card color comes from Area metadata.
Put the goal captured during retro/planning into each Area definition. The Area Explorer derives cards from the weekly board; it never stores a second task list.
Keep Wealth as the recovery Area or rename it in config. Its daily habit checkboxes use a week-scoped localStorage key and must not be overwritten by agents.

The HTML page is a mutable view. Issues/task records and WNN-outcomes.md remain sources of truth. Daily updates preserve the full ISO week and mutate only the marked regions.

Red Flags — STOP

Creating all issues in one repo → WRONG, route to correct repo per config
Creating issue without checking current state → VERIFY FIRST
Claiming status without checking actual data → VERIFY
Planning 40h of productive work → budget 60% capacity
Skipping calendar mapping → leads to conflicts
Mixing "task" with "outcome" → outcome = result by Friday
Doing execution work inside planning → finish planning first, execute separately
Asking the user for facts that are already available in sources → read sources first
Writing deadlines without checking the actual date → verify current date and week range
Replacing the entire plan during daily update → mutate only the marker regions and preserve browser habit state
Copying last week's filename or localStorage key → resolve the current ISO week with the generator

Common Mistakes

| Mistake | Fix | |---------|-----| | All issues in one repo | Route to where work happens | | Issue created without verification | Check issues + files + data first | | Outcomes = task list | Rewrite as "by Friday, X is true" | | Ignoring B2B as "bonus" | Active deals with money = outcomes | | Publishing paid content publicly | Paid content stays in paid repos | | Assuming data without checking | Verify with gh issue list + actual files | | Fixed 3 outcomes limit | As many outcomes as realistic | | Executing tasks during planning | Capture as outcomes/issues, execute after planning | | Asking instead of reading | Check source systems first, ask only for missing facts |

Integration with weekly-retro

This skill runs AFTER weekly-retro. Expected inputs:

Retro summary with what worked / didn't
Issues created during retro (label retro:W{NN-1})
Lessons learned and playbook updates
New tasks from retro interview

Setup

This skill reads config from your project's AGENTS.md / CLAUDE.md. Run corp-doctor first to generate or repair the config block, or add manually:

## Agent Operations Config

### Repos (scanned during retro/planning)
repos:
  - owner/repo-1    # what it does
  - owner/repo-2    # what it does

### GitHub Project
project_id: N
owner: your-github-handle

### Task Routing
routing:
  - pattern: "backend, bugs"
    repo: owner/backend-repo
  - pattern: "content, marketing"
    repo: owner/content-repo
  - pattern: "strategy, cross-cutting"
    repo: owner/main-repo

### Living plan
reports_dir: reports
local_timezone: system
display_timezones:
  - Europe/Berlin
  - Europe/Moscow
  - America/Argentina/Buenos_Aires
areas:
  - delivery
  - sales
  - systems
  - content
  - people
  - strategy
  - wealth
wealth_habits:
  - sport
  - reflection

Quick Reference

# All tasks for current week
gh search issues --owner $YOUR_OWNER --label "W{NN}" --state open

# By repo
gh search issues --owner $YOUR_OWNER --label "W{NN}" --state open --json repository,number,title

# Close week (Friday)
gh search issues --owner $YOUR_OWNER --label "W{NN}" --state open --json title,repository
# Review: done / spillover / drop

Agent Skills: Weekly Planning

Install this agent skill to your local

Skill Files