{
  "schemaVersion": "1.0",
  "item": {
    "slug": "4to1-planner",
    "name": "4To1 Planner - AI Planning Coach",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/qingxuantang/4to1-planner",
    "canonicalUrl": "https://clawhub.ai/qingxuantang/4to1-planner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/4to1-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4to1-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/setup.sh",
      "scripts/status.sh",
      "scripts/weekly_review.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/4to1-planner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/4to1-planner",
    "agentPageUrl": "https://openagent3.xyz/skills/4to1-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/4to1-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/4to1-planner/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "4To1 Planner — AI Planning Coach",
        "body": "\"From Vision to Action: 4to1\"\n\nAn AI-native planning coach that turns your 4-year vision into today's action — through conversation, not templates."
      },
      {
        "title": "The 4To1 Method™",
        "body": "A 4-layer strategic planning system. Each layer bridges the gap between vision and execution:\n\n4 YEARS  →  Strategic Vision     (Where am I going?)\n3 MONTHS →  Project Milestones   (Quarterly Gantt Log)\n2 WEEKS  →  Action Execution     (1 Day in a Week sprints)\n1 DAY    →  Daily Tasks          (Today's to-do list)\n\nPlus two elimination layers:\n\nNot-To-Do Projects: Things you explicitly say NO to\nTime Wasters: Daily habits you're eliminating\n\nCore principle: Every daily task connects to a 2-week sprint, which connects to a 3-month milestone, which connects to your 4-year vision. Nothing floats."
      },
      {
        "title": "Quick Start",
        "body": "User says any of these → this skill activates:\n\n\"Help me set up a planning system\"\n\"I want to plan my next 4 years\"\n\"Do my weekly review\"\n\"What should I focus on today?\"\n\"Set up 4to1 planner\""
      },
      {
        "title": "Setup: Connect Your Backend",
        "body": "The planner needs somewhere to store plans. Ask the user which they prefer:"
      },
      {
        "title": "Option 1: Notion (Recommended)",
        "body": "# 1. Create a Notion integration at https://www.notion.so/my-integrations\n# 2. Copy the API key (starts with ntn_)\n# 3. Store it:\nmkdir -p ~/.config/4to1\necho \"BACKEND=notion\" > ~/.config/4to1/config\necho \"NOTION_API_KEY=ntn_your_key_here\" >> ~/.config/4to1/config\n\nShare a parent page with the integration in Notion (click ··· → Connections → select your integration).\n\nCreate the planning workspace in Notion:\n\nNOTION_KEY=$(grep NOTION_API_KEY ~/.config/4to1/config | cut -d= -f2)\nPARENT_PAGE=$(grep NOTION_PARENT_PAGE ~/.config/4to1/config | cut -d= -f2)\n\n# Create the 4To1 Planning Hub page\ncurl -s -X POST \"https://api.notion.com/v1/pages\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"properties\\\": {\\\"title\\\": {\\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🎯 4To1 Planning Hub\\\"}}]}},\n    \\\"children\\\": [\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🔭 4-Year Vision\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Your strategic direction. Updated annually.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📊 3-Month Milestones\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Quarterly Gantt Log — project milestones for this quarter.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🏃 2-Week Sprint\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"1 Day in a Week — action execution in 2-week cycles.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🚫 Not-To-Do List\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Projects and commitments you are explicitly saying NO to.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"⏰ Time Wasters\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Daily habits you are eliminating.\\\"}}]}}\n    ]\n  }\"\n\n# Create Projects database (tracks items across all 4 layers)\ncurl -s -X POST \"https://api.notion.com/v1/databases\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📋 4To1 Projects\\\"}}],\n    \\\"properties\\\": {\n      \\\"Name\\\": {\\\"title\\\": {}},\n      \\\"Status\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"Active\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"Planned\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"On Hold\\\", \\\"color\\\": \\\"yellow\\\"},\n        {\\\"name\\\": \\\"Done\\\", \\\"color\\\": \\\"gray\\\"},\n        {\\\"name\\\": \\\"Not-To-Do\\\", \\\"color\\\": \\\"red\\\"}\n      ]}},\n      \\\"Layer\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"4-Year Vision\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"3-Month Milestone\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"2-Week Sprint\\\", \\\"color\\\": \\\"orange\\\"},\n        {\\\"name\\\": \\\"1-Day Task\\\", \\\"color\\\": \\\"red\\\"}\n      ]}},\n      \\\"Priority\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"Primary\\\", \\\"color\\\": \\\"red\\\"},\n        {\\\"name\\\": \\\"Secondary\\\", \\\"color\\\": \\\"orange\\\"},\n        {\\\"name\\\": \\\"Nice-to-have\\\", \\\"color\\\": \\\"gray\\\"}\n      ]}},\n      \\\"Parent Project\\\": {\\\"rich_text\\\": {}},\n      \\\"Start Date\\\": {\\\"date\\\": {}},\n      \\\"End Date\\\": {\\\"date\\\": {}},\n      \\\"Progress\\\": {\\\"number\\\": {\\\"format\\\": \\\"percent\\\"}},\n      \\\"Notes\\\": {\\\"rich_text\\\": {}}\n    }\n  }\"\n\n# Create Sprint Log database (2-week tracking cycles)\ncurl -s -X POST \"https://api.notion.com/v1/databases\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📅 Sprint Log\\\"}}],\n    \\\"properties\\\": {\n      \\\"Sprint\\\": {\\\"title\\\": {}},\n      \\\"Focus Areas\\\": {\\\"rich_text\\\": {}},\n      \\\"Completed\\\": {\\\"number\\\": {}},\n      \\\"Planned\\\": {\\\"number\\\": {}},\n      \\\"Completion Rate\\\": {\\\"formula\\\": {\\\"expression\\\": \\\"if(prop(\\\\\\\"Planned\\\\\\\") > 0, round(prop(\\\\\\\"Completed\\\\\\\") / prop(\\\\\\\"Planned\\\\\\\") * 100), 0)\\\"}},\n      \\\"Reflection\\\": {\\\"rich_text\\\": {}},\n      \\\"Energy Level\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"🔥 High\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"😊 Normal\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"😴 Low\\\", \\\"color\\\": \\\"yellow\\\"},\n        {\\\"name\\\": \\\"💀 Burnt Out\\\", \\\"color\\\": \\\"red\\\"}\n      ]}}\n    }\n  }\""
      },
      {
        "title": "Option 2: Todoist",
        "body": "# 1. Get API token from https://app.todoist.com/app/settings/integrations/developer\necho \"BACKEND=todoist\" > ~/.config/4to1/config\necho \"TODOIST_API_KEY=your_token_here\" >> ~/.config/4to1/config\n\nCreate the 4To1 structure:\n\nTODOIST_KEY=$(grep TODOIST_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\nfor project in \"🔭 4-Year Vision\" \"📊 3-Month Milestones\" \"🏃 2-Week Sprint\" \"✅ Daily Tasks\" \"🚫 Not-To-Do\"; do\n  curl -s -X POST \"https://api.todoist.com/rest/v2/projects\" \\\n    -H \"Authorization: Bearer $TODOIST_KEY\" \\\n    -H \"Content-Type: application/json\" \\\n    -d \"{\\\"name\\\": \\\"$project\\\"}\"\ndone"
      },
      {
        "title": "Option 3: Google Calendar + Tasks",
        "body": "echo \"BACKEND=gcal\" > ~/.config/4to1/config\n# Requires Google OAuth — run the setup script:\npython3 {baseDir}/scripts/gcal_setup.py"
      },
      {
        "title": "Option 4: Local Markdown (No account needed)",
        "body": "echo \"BACKEND=local\" > ~/.config/4to1/config\necho \"LOCAL_DIR=~/4to1-plans\" >> ~/.config/4to1/config\nmkdir -p ~/4to1-plans/{vision,milestones,sprints,daily,not-to-do}"
      },
      {
        "title": "1. Onboarding — \"Set up my planning system\"",
        "body": "Guide the user through this conversation:\n\nStep 1: Choose backend (see Setup above)\n\nStep 2: 4-Year Vision (5-10 min conversation)\n\nAsk one at a time, conversationally:\n\n\"If you could be anywhere in 4 years — career, life, skills — what does that look like?\"\n\"What are the 2-3 biggest areas you want to transform?\" (career, health, relationships, skills, finances)\n\"For each area, what does SUCCESS look like in 4 years? Be specific.\"\n\"What are you willing to give up to get there?\" → seeds the Not-To-Do list\n\"Any daily habits stealing your time?\" → seeds the Time Wasters list\n\nAfter the conversation, create:\n\n4-Year Vision document with their answers (Layer: 4-Year Vision)\n2-5 vision areas with concrete success criteria\nInitial Not-To-Do list + Time Wasters list\n\nStep 3: 3-Month Milestones (5 min)\n\n\"Of your vision areas, which 1-2 need the most progress in the next 3 months?\"\n\"What specific milestones would mean real progress?\"\n\"Break each into measurable deliverables.\"\n\nCreate items with Layer: 3-Month Milestone, linked to vision areas.\n\nStep 4: 2-Week Sprint (3 min)\n\n\"For your quarterly milestones, what can you accomplish in the next 2 weeks?\"\n\"Pick 2 Primary projects and up to 5 Secondary projects.\"\n\"What does 'done' look like for each?\"\n\nCreate items with Layer: 2-Week Sprint.\n\nStep 5: Today (1 min)\n\n\"What are the 3 most important tasks for today?\"\n\"Which sprint project does each serve?\"\n\nWrite everything to the chosen backend."
      },
      {
        "title": "2. Weekly Review — \"Do my weekly review\"",
        "body": "Run every Sunday evening or Monday morning. Read {baseDir}/scripts/weekly_review.md for the full template.\n\nSummary:\n\nREAD: This week's tasks + completion status + project progress + Not-To-Do list\nASK:  How did this week go? → Wins? → Blockers? → Energy level?\n      → Did you spend time on Not-To-Do items? → Next week's top 3?\nWRITE: Sprint log entry + next week's tasks + updated progress\n\nKeep it under 10 minutes. Be a coach, not a form."
      },
      {
        "title": "3. Bi-Weekly Sprint Review — Every 2 weeks",
        "body": "READ: Current 2-week sprint tasks and progress\nREVIEW: What got done? What carries over? Any sprint goal changes?\nPLAN: Next 2-week sprint — new primary/secondary projects\nCHECK: Are sprints still aligned with 3-month milestones?"
      },
      {
        "title": "4. Quarterly Review — End of each quarter",
        "body": "READ: All projects and sprint logs for the quarter\nREPORT: Projects completed/stalled/abandoned, completion trend, top win, biggest blocker\nASK: Which projects continue? Which get cut? New projects? Update Not-To-Do?\nWRITE: Quarterly report + next quarter's milestones"
      },
      {
        "title": "5. Daily Check-in — \"What should I focus on today?\"",
        "body": "READ: Current sprint tasks + project priorities\nRESPOND:\n  \"Based on your 2-week sprint, today's focus:\n   1. [Task] → serves [3-month milestone]\n   2. [Task] → serves [milestone]\n   3. [Task]\n\n   ⚠️ [Project X] hasn't had progress in a week.\n   🚫 Not-To-Do reminder: You said NO to [thing].\""
      },
      {
        "title": "6. Quick Add — \"Add [task] to my plan\"",
        "body": "Parse the task. Ask which project/sprint it serves if unclear. Add to backend with correct layer linkage."
      },
      {
        "title": "7. Progress Check — \"How am I doing?\"",
        "body": "READ: All data\nSHOW:\n  🔭 4-Year Vision: [areas and direction]\n  📊 Q[X] Milestones: [X/Y complete]\n  🏃 Current Sprint: [X/Y tasks done, Z% rate]\n  📈 Sprint streak: X consecutive reviews\n  🚫 Not-To-Do violations: [any this week?]"
      },
      {
        "title": "Notion API Reference",
        "body": "NOTION_KEY=$(grep NOTION_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\n# Search planning pages\ncurl -s -X POST \"https://api.notion.com/v1/search\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"4To1\"}'\n\n# Query projects by layer\ncurl -s -X POST \"https://api.notion.com/v1/databases/{db_id}/query\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"filter\": {\"and\": [\n    {\"property\": \"Status\", \"select\": {\"equals\": \"Active\"}},\n    {\"property\": \"Layer\", \"select\": {\"equals\": \"2-Week Sprint\"}}\n  ]}}'\n\n# Update progress\ncurl -s -X PATCH \"https://api.notion.com/v1/pages/{page_id}\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"properties\": {\"Progress\": {\"number\": 0.75}, \"Status\": {\"select\": {\"name\": \"Active\"}}}}'\n\n# Create sprint log entry\ncurl -s -X POST \"https://api.notion.com/v1/pages\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"parent\": {\"database_id\": \"{sprint_log_db_id}\"},\n    \"properties\": {\n      \"Sprint\": {\"title\": [{\"text\": {\"content\": \"2026-W07 Sprint Review\"}}]},\n      \"Completed\": {\"number\": 8},\n      \"Planned\": {\"number\": 10},\n      \"Reflection\": {\"rich_text\": [{\"text\": {\"content\": \"Good sprint. Hit main milestones.\"}}]},\n      \"Energy Level\": {\"select\": {\"name\": \"😊 Normal\"}}\n    }\n  }'"
      },
      {
        "title": "Todoist API Reference",
        "body": "TODOIST_KEY=$(grep TODOIST_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\n# Get all projects\ncurl -s \"https://api.todoist.com/rest/v2/projects\" -H \"Authorization: Bearer $TODOIST_KEY\"\n\n# Get active tasks in a project\ncurl -s \"https://api.todoist.com/rest/v2/tasks?project_id={id}\" -H \"Authorization: Bearer $TODOIST_KEY\"\n\n# Create task linked to sprint\ncurl -s -X POST \"https://api.todoist.com/rest/v2/tasks\" \\\n  -H \"Authorization: Bearer $TODOIST_KEY\" -H \"Content-Type: application/json\" \\\n  -d '{\"content\": \"Task name\", \"project_id\": \"xxx\", \"priority\": 4, \"due_string\": \"next monday\", \"description\": \"Sprint: 2-Week Sprint | Milestone: Q1 Goal\"}'\n\n# Complete task\ncurl -s -X POST \"https://api.todoist.com/rest/v2/tasks/{id}/close\" -H \"Authorization: Bearer $TODOIST_KEY\""
      },
      {
        "title": "Local Markdown Backend",
        "body": "~/4to1-plans/\n├── vision.md            # 4-year vision document\n├── not-to-do.md         # Not-To-Do projects + Time Wasters\n├── milestones/\n│   └── 2026-Q1.md       # 3-month milestone plan\n├── sprints/\n│   ├── 2026-W07.md      # 2-week sprint plan\n│   └── 2026-W09.md\n├── daily/\n│   └── 2026-02-10.md    # Daily task list\n└── reviews/\n    ├── sprint-2026-W07.md  # Sprint review log\n    └── quarterly-2026-Q1.md\n\nUse YAML frontmatter for structured data:\n\n---\nproject: Launch MVP\nlayer: 3-month-milestone\nstatus: active\npriority: primary\nprogress: 45\nstart: 2026-01-01\nend: 2026-03-31\nparent_vision: \"Build a profitable SaaS\"\n---\n# Launch MVP\n## Tasks (2-week sprint)\n- [x] Define feature scope\n- [x] Build prototype\n- [ ] User testing round 1\n- [ ] Iterate on feedback"
      },
      {
        "title": "Automation (Heartbeat/Cron)",
        "body": "For OpenClaw users with heartbeats or cron:\n\nWeekly review reminder (Sunday 8pm):\n\n\"Run 4to1 weekly review: read sprint progress, generate summary, ask for next week's priorities\"\n\nDaily focus (weekdays 8am):\n\n\"Check 4to1 plan, suggest today's top 3 focus tasks based on current 2-week sprint\"\n\nStall detection (every 3 days):\n\n\"Check if any active 4to1 sprint project hasn't been updated in 1+ week. Alert if stalled.\""
      },
      {
        "title": "Coach Principles",
        "body": "Respect the 4-3-2-1 hierarchy — every task connects up through sprint → milestone → vision\nProtect the Not-To-Do list — if user adds something conflicting, remind them why they said no\nNever fabricate progress — only report what's actually tracked\nKeep it lightweight — weekly review = 5-10 min, daily check-in = 1 min\nBe encouraging but honest — celebrate wins, flag stalls kindly\nThink in 2-week cycles — the sprint is the core execution rhythm"
      },
      {
        "title": "Learn More",
        "body": "Website: https://4to1planner.com\nFree starter kit: https://4to1planner.com/free-download.html\nTemplates: https://4to1planner.com/shop.html\nYouTube: https://www.youtube.com/@markzhou5213\nTwitter: https://twitter.com/xiucat"
      }
    ],
    "body": "4To1 Planner — AI Planning Coach\n\n\"From Vision to Action: 4to1\"\n\nAn AI-native planning coach that turns your 4-year vision into today's action — through conversation, not templates.\n\nThe 4To1 Method™\n\nA 4-layer strategic planning system. Each layer bridges the gap between vision and execution:\n\n4 YEARS  →  Strategic Vision     (Where am I going?)\n3 MONTHS →  Project Milestones   (Quarterly Gantt Log)\n2 WEEKS  →  Action Execution     (1 Day in a Week sprints)\n1 DAY    →  Daily Tasks          (Today's to-do list)\n\n\nPlus two elimination layers:\n\nNot-To-Do Projects: Things you explicitly say NO to\nTime Wasters: Daily habits you're eliminating\n\nCore principle: Every daily task connects to a 2-week sprint, which connects to a 3-month milestone, which connects to your 4-year vision. Nothing floats.\n\nQuick Start\n\nUser says any of these → this skill activates:\n\n\"Help me set up a planning system\"\n\"I want to plan my next 4 years\"\n\"Do my weekly review\"\n\"What should I focus on today?\"\n\"Set up 4to1 planner\"\nSetup: Connect Your Backend\n\nThe planner needs somewhere to store plans. Ask the user which they prefer:\n\nOption 1: Notion (Recommended)\n# 1. Create a Notion integration at https://www.notion.so/my-integrations\n# 2. Copy the API key (starts with ntn_)\n# 3. Store it:\nmkdir -p ~/.config/4to1\necho \"BACKEND=notion\" > ~/.config/4to1/config\necho \"NOTION_API_KEY=ntn_your_key_here\" >> ~/.config/4to1/config\n\n\nShare a parent page with the integration in Notion (click ··· → Connections → select your integration).\n\nCreate the planning workspace in Notion:\n\nNOTION_KEY=$(grep NOTION_API_KEY ~/.config/4to1/config | cut -d= -f2)\nPARENT_PAGE=$(grep NOTION_PARENT_PAGE ~/.config/4to1/config | cut -d= -f2)\n\n# Create the 4To1 Planning Hub page\ncurl -s -X POST \"https://api.notion.com/v1/pages\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"properties\\\": {\\\"title\\\": {\\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🎯 4To1 Planning Hub\\\"}}]}},\n    \\\"children\\\": [\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🔭 4-Year Vision\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Your strategic direction. Updated annually.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📊 3-Month Milestones\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Quarterly Gantt Log — project milestones for this quarter.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🏃 2-Week Sprint\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"1 Day in a Week — action execution in 2-week cycles.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"🚫 Not-To-Do List\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Projects and commitments you are explicitly saying NO to.\\\"}}]}},\n      {\\\"type\\\": \\\"heading_1\\\", \\\"heading_1\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"⏰ Time Wasters\\\"}}]}},\n      {\\\"type\\\": \\\"paragraph\\\", \\\"paragraph\\\": {\\\"rich_text\\\": [{\\\"text\\\": {\\\"content\\\": \\\"Daily habits you are eliminating.\\\"}}]}}\n    ]\n  }\"\n\n# Create Projects database (tracks items across all 4 layers)\ncurl -s -X POST \"https://api.notion.com/v1/databases\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📋 4To1 Projects\\\"}}],\n    \\\"properties\\\": {\n      \\\"Name\\\": {\\\"title\\\": {}},\n      \\\"Status\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"Active\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"Planned\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"On Hold\\\", \\\"color\\\": \\\"yellow\\\"},\n        {\\\"name\\\": \\\"Done\\\", \\\"color\\\": \\\"gray\\\"},\n        {\\\"name\\\": \\\"Not-To-Do\\\", \\\"color\\\": \\\"red\\\"}\n      ]}},\n      \\\"Layer\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"4-Year Vision\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"3-Month Milestone\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"2-Week Sprint\\\", \\\"color\\\": \\\"orange\\\"},\n        {\\\"name\\\": \\\"1-Day Task\\\", \\\"color\\\": \\\"red\\\"}\n      ]}},\n      \\\"Priority\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"Primary\\\", \\\"color\\\": \\\"red\\\"},\n        {\\\"name\\\": \\\"Secondary\\\", \\\"color\\\": \\\"orange\\\"},\n        {\\\"name\\\": \\\"Nice-to-have\\\", \\\"color\\\": \\\"gray\\\"}\n      ]}},\n      \\\"Parent Project\\\": {\\\"rich_text\\\": {}},\n      \\\"Start Date\\\": {\\\"date\\\": {}},\n      \\\"End Date\\\": {\\\"date\\\": {}},\n      \\\"Progress\\\": {\\\"number\\\": {\\\"format\\\": \\\"percent\\\"}},\n      \\\"Notes\\\": {\\\"rich_text\\\": {}}\n    }\n  }\"\n\n# Create Sprint Log database (2-week tracking cycles)\ncurl -s -X POST \"https://api.notion.com/v1/databases\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\n    \\\"parent\\\": {\\\"page_id\\\": \\\"$PARENT_PAGE\\\"},\n    \\\"title\\\": [{\\\"text\\\": {\\\"content\\\": \\\"📅 Sprint Log\\\"}}],\n    \\\"properties\\\": {\n      \\\"Sprint\\\": {\\\"title\\\": {}},\n      \\\"Focus Areas\\\": {\\\"rich_text\\\": {}},\n      \\\"Completed\\\": {\\\"number\\\": {}},\n      \\\"Planned\\\": {\\\"number\\\": {}},\n      \\\"Completion Rate\\\": {\\\"formula\\\": {\\\"expression\\\": \\\"if(prop(\\\\\\\"Planned\\\\\\\") > 0, round(prop(\\\\\\\"Completed\\\\\\\") / prop(\\\\\\\"Planned\\\\\\\") * 100), 0)\\\"}},\n      \\\"Reflection\\\": {\\\"rich_text\\\": {}},\n      \\\"Energy Level\\\": {\\\"select\\\": {\\\"options\\\": [\n        {\\\"name\\\": \\\"🔥 High\\\", \\\"color\\\": \\\"green\\\"},\n        {\\\"name\\\": \\\"😊 Normal\\\", \\\"color\\\": \\\"blue\\\"},\n        {\\\"name\\\": \\\"😴 Low\\\", \\\"color\\\": \\\"yellow\\\"},\n        {\\\"name\\\": \\\"💀 Burnt Out\\\", \\\"color\\\": \\\"red\\\"}\n      ]}}\n    }\n  }\"\n\nOption 2: Todoist\n# 1. Get API token from https://app.todoist.com/app/settings/integrations/developer\necho \"BACKEND=todoist\" > ~/.config/4to1/config\necho \"TODOIST_API_KEY=your_token_here\" >> ~/.config/4to1/config\n\n\nCreate the 4To1 structure:\n\nTODOIST_KEY=$(grep TODOIST_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\nfor project in \"🔭 4-Year Vision\" \"📊 3-Month Milestones\" \"🏃 2-Week Sprint\" \"✅ Daily Tasks\" \"🚫 Not-To-Do\"; do\n  curl -s -X POST \"https://api.todoist.com/rest/v2/projects\" \\\n    -H \"Authorization: Bearer $TODOIST_KEY\" \\\n    -H \"Content-Type: application/json\" \\\n    -d \"{\\\"name\\\": \\\"$project\\\"}\"\ndone\n\nOption 3: Google Calendar + Tasks\necho \"BACKEND=gcal\" > ~/.config/4to1/config\n# Requires Google OAuth — run the setup script:\npython3 {baseDir}/scripts/gcal_setup.py\n\nOption 4: Local Markdown (No account needed)\necho \"BACKEND=local\" > ~/.config/4to1/config\necho \"LOCAL_DIR=~/4to1-plans\" >> ~/.config/4to1/config\nmkdir -p ~/4to1-plans/{vision,milestones,sprints,daily,not-to-do}\n\nCore Commands\n1. Onboarding — \"Set up my planning system\"\n\nGuide the user through this conversation:\n\nStep 1: Choose backend (see Setup above)\n\nStep 2: 4-Year Vision (5-10 min conversation)\n\nAsk one at a time, conversationally:\n\n\"If you could be anywhere in 4 years — career, life, skills — what does that look like?\"\n\"What are the 2-3 biggest areas you want to transform?\" (career, health, relationships, skills, finances)\n\"For each area, what does SUCCESS look like in 4 years? Be specific.\"\n\"What are you willing to give up to get there?\" → seeds the Not-To-Do list\n\"Any daily habits stealing your time?\" → seeds the Time Wasters list\n\nAfter the conversation, create:\n\n4-Year Vision document with their answers (Layer: 4-Year Vision)\n2-5 vision areas with concrete success criteria\nInitial Not-To-Do list + Time Wasters list\n\nStep 3: 3-Month Milestones (5 min)\n\n\"Of your vision areas, which 1-2 need the most progress in the next 3 months?\"\n\"What specific milestones would mean real progress?\"\n\"Break each into measurable deliverables.\"\n\nCreate items with Layer: 3-Month Milestone, linked to vision areas.\n\nStep 4: 2-Week Sprint (3 min)\n\n\"For your quarterly milestones, what can you accomplish in the next 2 weeks?\"\n\"Pick 2 Primary projects and up to 5 Secondary projects.\"\n\"What does 'done' look like for each?\"\n\nCreate items with Layer: 2-Week Sprint.\n\nStep 5: Today (1 min)\n\n\"What are the 3 most important tasks for today?\"\n\"Which sprint project does each serve?\"\n\nWrite everything to the chosen backend.\n\n2. Weekly Review — \"Do my weekly review\"\n\nRun every Sunday evening or Monday morning. Read {baseDir}/scripts/weekly_review.md for the full template.\n\nSummary:\n\nREAD: This week's tasks + completion status + project progress + Not-To-Do list\nASK:  How did this week go? → Wins? → Blockers? → Energy level?\n      → Did you spend time on Not-To-Do items? → Next week's top 3?\nWRITE: Sprint log entry + next week's tasks + updated progress\n\n\nKeep it under 10 minutes. Be a coach, not a form.\n\n3. Bi-Weekly Sprint Review — Every 2 weeks\nREAD: Current 2-week sprint tasks and progress\nREVIEW: What got done? What carries over? Any sprint goal changes?\nPLAN: Next 2-week sprint — new primary/secondary projects\nCHECK: Are sprints still aligned with 3-month milestones?\n\n4. Quarterly Review — End of each quarter\nREAD: All projects and sprint logs for the quarter\nREPORT: Projects completed/stalled/abandoned, completion trend, top win, biggest blocker\nASK: Which projects continue? Which get cut? New projects? Update Not-To-Do?\nWRITE: Quarterly report + next quarter's milestones\n\n5. Daily Check-in — \"What should I focus on today?\"\nREAD: Current sprint tasks + project priorities\nRESPOND:\n  \"Based on your 2-week sprint, today's focus:\n   1. [Task] → serves [3-month milestone]\n   2. [Task] → serves [milestone]\n   3. [Task]\n\n   ⚠️ [Project X] hasn't had progress in a week.\n   🚫 Not-To-Do reminder: You said NO to [thing].\"\n\n6. Quick Add — \"Add [task] to my plan\"\n\nParse the task. Ask which project/sprint it serves if unclear. Add to backend with correct layer linkage.\n\n7. Progress Check — \"How am I doing?\"\nREAD: All data\nSHOW:\n  🔭 4-Year Vision: [areas and direction]\n  📊 Q[X] Milestones: [X/Y complete]\n  🏃 Current Sprint: [X/Y tasks done, Z% rate]\n  📈 Sprint streak: X consecutive reviews\n  🚫 Not-To-Do violations: [any this week?]\n\nNotion API Reference\nNOTION_KEY=$(grep NOTION_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\n# Search planning pages\ncurl -s -X POST \"https://api.notion.com/v1/search\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"4To1\"}'\n\n# Query projects by layer\ncurl -s -X POST \"https://api.notion.com/v1/databases/{db_id}/query\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"filter\": {\"and\": [\n    {\"property\": \"Status\", \"select\": {\"equals\": \"Active\"}},\n    {\"property\": \"Layer\", \"select\": {\"equals\": \"2-Week Sprint\"}}\n  ]}}'\n\n# Update progress\ncurl -s -X PATCH \"https://api.notion.com/v1/pages/{page_id}\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"properties\": {\"Progress\": {\"number\": 0.75}, \"Status\": {\"select\": {\"name\": \"Active\"}}}}'\n\n# Create sprint log entry\ncurl -s -X POST \"https://api.notion.com/v1/pages\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"parent\": {\"database_id\": \"{sprint_log_db_id}\"},\n    \"properties\": {\n      \"Sprint\": {\"title\": [{\"text\": {\"content\": \"2026-W07 Sprint Review\"}}]},\n      \"Completed\": {\"number\": 8},\n      \"Planned\": {\"number\": 10},\n      \"Reflection\": {\"rich_text\": [{\"text\": {\"content\": \"Good sprint. Hit main milestones.\"}}]},\n      \"Energy Level\": {\"select\": {\"name\": \"😊 Normal\"}}\n    }\n  }'\n\nTodoist API Reference\nTODOIST_KEY=$(grep TODOIST_API_KEY ~/.config/4to1/config | cut -d= -f2)\n\n# Get all projects\ncurl -s \"https://api.todoist.com/rest/v2/projects\" -H \"Authorization: Bearer $TODOIST_KEY\"\n\n# Get active tasks in a project\ncurl -s \"https://api.todoist.com/rest/v2/tasks?project_id={id}\" -H \"Authorization: Bearer $TODOIST_KEY\"\n\n# Create task linked to sprint\ncurl -s -X POST \"https://api.todoist.com/rest/v2/tasks\" \\\n  -H \"Authorization: Bearer $TODOIST_KEY\" -H \"Content-Type: application/json\" \\\n  -d '{\"content\": \"Task name\", \"project_id\": \"xxx\", \"priority\": 4, \"due_string\": \"next monday\", \"description\": \"Sprint: 2-Week Sprint | Milestone: Q1 Goal\"}'\n\n# Complete task\ncurl -s -X POST \"https://api.todoist.com/rest/v2/tasks/{id}/close\" -H \"Authorization: Bearer $TODOIST_KEY\"\n\nLocal Markdown Backend\n~/4to1-plans/\n├── vision.md            # 4-year vision document\n├── not-to-do.md         # Not-To-Do projects + Time Wasters\n├── milestones/\n│   └── 2026-Q1.md       # 3-month milestone plan\n├── sprints/\n│   ├── 2026-W07.md      # 2-week sprint plan\n│   └── 2026-W09.md\n├── daily/\n│   └── 2026-02-10.md    # Daily task list\n└── reviews/\n    ├── sprint-2026-W07.md  # Sprint review log\n    └── quarterly-2026-Q1.md\n\n\nUse YAML frontmatter for structured data:\n\n---\nproject: Launch MVP\nlayer: 3-month-milestone\nstatus: active\npriority: primary\nprogress: 45\nstart: 2026-01-01\nend: 2026-03-31\nparent_vision: \"Build a profitable SaaS\"\n---\n# Launch MVP\n## Tasks (2-week sprint)\n- [x] Define feature scope\n- [x] Build prototype\n- [ ] User testing round 1\n- [ ] Iterate on feedback\n\nAutomation (Heartbeat/Cron)\n\nFor OpenClaw users with heartbeats or cron:\n\nWeekly review reminder (Sunday 8pm):\n\n\"Run 4to1 weekly review: read sprint progress, generate summary, ask for next week's priorities\"\n\n\nDaily focus (weekdays 8am):\n\n\"Check 4to1 plan, suggest today's top 3 focus tasks based on current 2-week sprint\"\n\n\nStall detection (every 3 days):\n\n\"Check if any active 4to1 sprint project hasn't been updated in 1+ week. Alert if stalled.\"\n\nCoach Principles\nRespect the 4-3-2-1 hierarchy — every task connects up through sprint → milestone → vision\nProtect the Not-To-Do list — if user adds something conflicting, remind them why they said no\nNever fabricate progress — only report what's actually tracked\nKeep it lightweight — weekly review = 5-10 min, daily check-in = 1 min\nBe encouraging but honest — celebrate wins, flag stalls kindly\nThink in 2-week cycles — the sprint is the core execution rhythm\nLearn More\nWebsite: https://4to1planner.com\nFree starter kit: https://4to1planner.com/free-download.html\nTemplates: https://4to1planner.com/shop.html\nYouTube: https://www.youtube.com/@markzhou5213\nTwitter: https://twitter.com/xiucat"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/qingxuantang/4to1-planner",
    "publisherUrl": "https://clawhub.ai/qingxuantang/4to1-planner",
    "owner": "qingxuantang",
    "version": "2.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/4to1-planner",
    "downloadUrl": "https://openagent3.xyz/downloads/4to1-planner",
    "agentUrl": "https://openagent3.xyz/skills/4to1-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/4to1-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/4to1-planner/agent.md"
  }
}