Skip to content

serejaris/personal-corp-os / skills/weekly-planning

weekly-planning

Verified

Use when the user is transitioning from a completed retro into a weekly plan, choosing weekly outcomes, scheduling a full ISO week, or asking for "план на неделю", "weekly planning", priorities, capacity, or outcomes.

FileKindSize
SKILL.mdskill md9.4 KB
assets/illustration.pngbinary541.8 KB
assets/living-week-plan.htmlother21.0 KB
scripts/living_week.pyscript3.7 KB

scripts/living_week.py

View on GitHub
#!/usr/bin/env python3
"""Resolve an ISO week and create a public-safe living weekly plan."""

from __future__ import annotations

import argparse
import json
from datetime import date, datetime, timedelta
from pathlib import Path


SKILL_DIR = Path(__file__).resolve().parents[1]
TEMPLATE = SKILL_DIR / "assets" / "living-week-plan.html"
WEEKDAYS_RU = ("Пн", "Вт", "Ср", "Чт", "Пт", "Сб", "Вс")
MONTHS_RU = (
    "января",
    "февраля",
    "марта",
    "апреля",
    "мая",
    "июня",
    "июля",
    "августа",
    "сентября",
    "октября",
    "ноября",
    "декабря",
)


def parse_date(value: str | None) -> date:
    return date.fromisoformat(value) if value else date.today()


def week_context(today: date, workspace: Path, reports_dir: str) -> dict[str, object]:
    iso_year, week, weekday = today.isocalendar()
    start = today - timedelta(days=weekday - 1)
    end = start + timedelta(days=6)
    label = f"W{week}"
    days = [start + timedelta(days=offset) for offset in range(7)]
    return {
        "today": today.isoformat(),
        "iso_year": iso_year,
        "week": week,
        "week_label": label,
        "week_start": start.isoformat(),
        "week_end": end.isoformat(),
        "week_range": f"{start.day}–{end.day} {MONTHS_RU[end.month - 1]} {end.year}",
        "days": [item.isoformat() for item in days],
        "plan_file": str(workspace / reports_dir / f"{label}-plan.html"),
        "outcomes_file": str(workspace / reports_dir / f"{label}-outcomes.md"),
        "habit_storage_key": f"personal-corp.plan.{label}.wealth.v1",
    }


def render(context: dict[str, object]) -> str:
    html = TEMPLATE.read_text(encoding="utf-8")
    replacements = {
        "{{WEEK_LABEL}}": str(context["week_label"]),
        "{{WEEK_RANGE}}": str(context["week_range"]),
        "{{UPDATED_AT}}": datetime.now().astimezone().isoformat(timespec="minutes"),
        "{{HABIT_STORAGE_KEY}}": str(context["habit_storage_key"]),
    }
    for index, day_value in enumerate(context["days"], start=1):
        day = date.fromisoformat(str(day_value))
        replacements[f"{{{{DAY_{index}_ISO}}}}"] = day.isoformat()
        replacements[f"{{{{DAY_{index}_LABEL}}}}"] = f"{WEEKDAYS_RU[index - 1]} {day:%d.%m}"
    for token, value in replacements.items():
        html = html.replace(token, value)
    return html


def parser() -> argparse.ArgumentParser:
    result = argparse.ArgumentParser(description=__doc__)
    result.add_argument("command", choices=("context", "create"))
    result.add_argument("--date", help="Local date as YYYY-MM-DD")
    result.add_argument("--workspace", default=".")
    result.add_argument("--reports-dir", default="reports")
    result.add_argument("--force", action="store_true")
    result.add_argument("--json", action="store_true")
    return result


def main() -> int:
    args = parser().parse_args()
    workspace = Path(args.workspace).expanduser().resolve()
    context = week_context(parse_date(args.date), workspace, args.reports_dir)
    if args.command == "context":
        if args.json:
            print(json.dumps(context, ensure_ascii=False, indent=2))
        else:
            print(f"{context['week_label']} {context['week_start']}..{context['week_end']}")
            print(context["plan_file"])
        return 0

    output = Path(str(context["plan_file"]))
    if output.exists() and not args.force:
        raise SystemExit(f"Refusing to overwrite existing plan: {output}")
    output.parent.mkdir(parents=True, exist_ok=True)
    output.write_text(render(context), encoding="utf-8")
    print(output)
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall