{"id":"f54e9bb2-8d77-45a3-9260-205a33c2e392","shortId":"XMeJaL","kind":"skill","title":"planning-with-files","tagline":"Work like Manus: Use persistent markdown files as your \"working memory on disk.\"","description":"# Planning with Files\n\nWork like Manus: Use persistent markdown files as your \"working memory on disk.\"\n\n## Important: Where Files Go\n\nWhen using this skill:\n\n- **Templates** are stored in the skill directory at `${CLAUDE_PLUGIN_ROOT}/templates/`\n- **Your planning files** (`task_plan.md`, `findings.md`, `progress.md`) should be created in **your project directory** — the folder where you're working\n\n| Location | What Goes There |\n|----------|-----------------|\n| Skill directory (`${CLAUDE_PLUGIN_ROOT}/`) | Templates, scripts, reference docs |\n| Your project directory | `task_plan.md`, `findings.md`, `progress.md` |\n\nThis ensures your planning files live alongside your code, not buried in the skill installation folder.\n\n## Quick Start\n\nBefore ANY complex task:\n\n1. **Create `task_plan.md`** in your project — Use [templates/task_plan.md](templates/task_plan.md) as reference\n2. **Create `findings.md`** in your project — Use [templates/findings.md](templates/findings.md) as reference\n3. **Create `progress.md`** in your project — Use [templates/progress.md](templates/progress.md) as reference\n4. **Re-read plan before decisions** — Refreshes goals in attention window\n5. **Update after each phase** — Mark complete, log errors\n\n> **Note:** All three planning files should be created in your current working directory (your project root), not in the skill's installation folder.\n\n## The Core Pattern\n\n```\nContext Window = RAM (volatile, limited)\nFilesystem = Disk (persistent, unlimited)\n\n→ Anything important gets written to disk.\n```\n\n## File Purposes\n\n| File | Purpose | When to Update |\n|------|---------|----------------|\n| `task_plan.md` | Phases, progress, decisions | After each phase |\n| `findings.md` | Research, discoveries | After ANY discovery |\n| `progress.md` | Session log, test results | Throughout session |\n\n## Critical Rules\n\n### 1. Create Plan First\nNever start a complex task without `task_plan.md`. Non-negotiable.\n\n### 2. The 2-Action Rule\n> \"After every 2 view/browser/search operations, IMMEDIATELY save key findings to text files.\"\n\nThis prevents visual/multimodal information from being lost.\n\n### 3. Read Before Decide\nBefore major decisions, read the plan file. This keeps goals in your attention window.\n\n### 4. Update After Act\nAfter completing any phase:\n- Mark phase status: `in_progress` → `complete`\n- Log any errors encountered\n- Note files created/modified\n\n### 5. Log ALL Errors\nEvery error goes in the plan file. This builds knowledge and prevents repetition.\n\n```markdown\n## Errors Encountered\n| Error | Attempt | Resolution |\n|-------|---------|------------|\n| FileNotFoundError | 1 | Created default config |\n| API timeout | 2 | Added retry logic |\n```\n\n### 6. Never Repeat Failures\n```\nif action_failed:\n    next_action != same_action\n```\nTrack what you tried. Mutate the approach.\n\n## The 3-Strike Error Protocol\n\n```\nATTEMPT 1: Diagnose & Fix\n  → Read error carefully\n  → Identify root cause\n  → Apply targeted fix\n\nATTEMPT 2: Alternative Approach\n  → Same error? Try different method\n  → Different tool? Different library?\n  → NEVER repeat exact same failing action\n\nATTEMPT 3: Broader Rethink\n  → Question assumptions\n  → Search for solutions\n  → Consider updating the plan\n\nAFTER 3 FAILURES: Escalate to User\n  → Explain what you tried\n  → Share the specific error\n  → Ask for guidance\n```\n\n## Read vs Write Decision Matrix\n\n| Situation | Action | Reason |\n|-----------|--------|--------|\n| Just wrote a file | DON'T read | Content still in context |\n| Viewed image/PDF | Write findings NOW | Multimodal → text before lost |\n| Browser returned data | Write to file | Screenshots don't persist |\n| Starting new phase | Read plan/findings | Re-orient if context stale |\n| Error occurred | Read relevant file | Need current state to fix |\n| Resuming after gap | Read all planning files | Recover state |\n\n## The 5-Question Reboot Test\n\nIf you can answer these, your context management is solid:\n\n| Question | Answer Source |\n|----------|---------------|\n| Where am I? | Current phase in task_plan.md |\n| Where am I going? | Remaining phases |\n| What's the goal? | Goal statement in plan |\n| What have I learned? | findings.md |\n| What have I done? | progress.md |\n\n## When to Use This Pattern\n\n**Use for:**\n- Multi-step tasks (3+ steps)\n- Research tasks\n- Building/creating projects\n- Tasks spanning many tool calls\n- Anything requiring organization\n\n**Skip for:**\n- Simple questions\n- Single-file edits\n- Quick lookups\n\n## Templates\n\nCopy these templates to start:\n\n- [templates/task_plan.md](templates/task_plan.md) — Phase tracking\n- [templates/findings.md](templates/findings.md) — Research storage\n- [templates/progress.md](templates/progress.md) — Session logging\n\n## Scripts\n\nHelper scripts for automation:\n\n- `scripts/init-session.sh` — Initialize all planning files\n- `scripts/check-complete.sh` — Verify all phases complete\n\n## Advanced Topics\n\n- **Manus Principles:** See [reference.md](reference.md)\n- **Real Examples:** See [examples.md](examples.md)\n\n## Anti-Patterns\n\n| Don't | Do Instead |\n|-------|------------|\n| Use TodoWrite for persistence | Create task_plan.md file |\n| State goals once and forget | Re-read plan before decisions |\n| Hide errors and retry silently | Log errors to plan file |\n| Stuff everything in context | Store large content in files |\n| Start executing immediately | Create plan file FIRST |\n| Repeat failed actions | Track attempts, mutate approach |\n| Create files in skill directory | Create files in your project |\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["planning","with","files","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-planning-with-files","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/planning-with-files","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34616 github stars · SKILL.md body (5,836 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T00:51:23.907Z","embedding":null,"createdAt":"2026-04-18T21:42:27.384Z","updatedAt":"2026-04-23T00:51:23.907Z","lastSeenAt":"2026-04-23T00:51:23.907Z","tsv":"'/templates':53 '1':114,238,339,373 '2':125,252,254,259,345,386 '3':136,276,368,405,418,562 '4':147,294 '5':159,315,503 '6':349 'act':297 'action':255,354,357,359,403,440,684 'ad':346 'advanc':619 'alongsid':98 'altern':387 'answer':510,518 'anti':632 'anti-pattern':631 'anyth':203,573 'api':343 'appli':382 'approach':366,388,688 'ask':431,732 'assumpt':409 'attempt':336,372,385,404,686 'attent':157,292 'autom':608 'boundari':740 'broader':406 'browser':462 'build':327 'building/creating':566 'buri':102 'call':572 'care':378 'caus':381 'clarif':734 'claud':50,79 'clear':707 'code':100 'complet':165,299,307,618 'complex':112,245 'config':342 'consid':413 'content':449,672 'context':194,452,481,513,669 'copi':587 'core':192 'creat':62,115,126,137,175,239,340,642,678,689,694 'created/modified':314 'criteria':743 'critic':236 'current':178,489,523 'data':464 'decid':279 'decis':153,219,282,437,655 'default':341 'describ':711 'diagnos':374 'differ':392,394,396 'directori':48,66,78,88,180,693 'discoveri':225,228 'disk':17,33,200,208 'doc':85 'done':549 'edit':583 'encount':311,334 'ensur':93 'environ':723 'environment-specif':722 'error':167,310,318,320,333,335,370,377,390,430,483,657,662 'escal':420 'everi':258,319 'everyth':667 'exact':400 'exampl':627 'examples.md':629,630 'execut':676 'expert':728 'explain':423 'fail':355,402,683 'failur':352,419 'file':4,11,20,27,36,56,96,172,209,211,268,286,313,325,445,467,487,499,582,613,644,665,674,680,690,695 'filenotfounderror':338 'filesystem':199 'find':265,456 'findings.md':58,90,127,223,545 'first':241,681 'fix':375,384,492 'folder':68,107,190 'forget':649 'gap':495 'get':205 'go':37,530 'goal':155,289,536,537,646 'goe':75,321 'guidanc':433 'helper':605 'hide':656 'identifi':379 'image/pdf':454 'immedi':262,677 'import':34,204 'inform':272 'initi':610 'input':737 'instal':106,189 'instead':637 'keep':288 'key':264 'knowledg':328 'larg':671 'learn':544 'librari':397 'like':6,22 'limit':198,699 'live':97 'locat':73 'log':166,231,308,316,603,661 'logic':348 'lookup':585 'lost':275,461 'major':281 'manag':514 'mani':570 'manus':7,23,621 'mark':164,302 'markdown':10,26,332 'match':708 'matrix':438 'memori':15,31 'method':393 'miss':745 'multi':559 'multi-step':558 'multimod':458 'mutat':364,687 'need':488 'negoti':251 'never':242,350,398 'new':473 'next':356 'non':250 'non-negoti':249 'note':168,312 'occur':484 'oper':261 'organ':575 'orient':479 'output':717 'pattern':193,555,633 'permiss':738 'persist':9,25,201,471,641 'phase':163,217,222,301,303,474,524,532,594,617 'plan':2,18,55,95,151,171,240,285,324,416,498,540,612,653,664,679 'plan/findings':476 'planning-with-fil':1 'plugin':51,80 'prevent':270,330 'principl':622 'progress':218,306 'progress.md':59,91,138,229,550 'project':65,87,119,130,141,182,567,698 'protocol':371 'purpos':210,212 'question':408,504,517,579 'quick':108,584 'ram':196 're':71,149,478,651 're-ori':477 're-read':148,650 'read':150,277,283,376,434,448,475,485,496,652 'real':626 'reason':441 'reboot':505 'recov':500 'refer':84,124,135,146 'reference.md':624,625 'refresh':154 'relev':486 'remain':531 'repeat':351,399,682 'repetit':331 'requir':574,736 'research':224,564,598 'resolut':337 'result':233 'resum':493 'rethink':407 'retri':347,659 'return':463 'review':729 'root':52,81,183,380 'rule':237,256 'safeti':739 'save':263 'scope':710 'screenshot':468 'script':83,604,606 'scripts/check-complete.sh':614 'scripts/init-session.sh':609 'search':410 'see':623,628 'session':230,235,602 'share':427 'silent':660 'simpl':578 'singl':581 'single-fil':580 'situat':439 'skill':41,47,77,105,187,692,702 'skill-planning-with-files' 'skip':576 'solid':516 'solut':412 'sourc':519 'source-sickn33' 'span':569 'specif':429,724 'stale':482 'start':109,243,472,591,675 'state':490,501,645 'statement':538 'status':304 'step':560,563 'still':450 'stop':730 'storag':599 'store':44,670 'strike':369 'stuff':666 'substitut':720 'success':742 'target':383 'task':113,246,561,565,568,706 'task_plan.md':57,89,116,216,248,526,643 'templat':42,82,586,589 'templates/findings.md':132,133,596,597 'templates/progress.md':143,144,600,601 'templates/task_plan.md':121,122,592,593 'test':232,506,726 'text':267,459 'three':170 'throughout':234 'timeout':344 'todowrit':639 'tool':395,571 'topic':620 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'track':360,595,685 'treat':715 'tri':363,391,426 'unlimit':202 'updat':160,215,295,414 'use':8,24,39,120,131,142,553,556,638,700 'user':422 'valid':725 'verifi':615 'view':453 'view/browser/search':260 'visual/multimodal':271 'volatil':197 'vs':435 'window':158,195,293 'without':247 'work':5,14,21,30,72,179 'write':436,455,465 'written':206 'wrote':443","prices":[{"id":"76288e8a-1eda-479c-a300-165d67301a35","listingId":"f54e9bb2-8d77-45a3-9260-205a33c2e392","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:42:27.384Z"}],"sources":[{"listingId":"f54e9bb2-8d77-45a3-9260-205a33c2e392","source":"github","sourceId":"sickn33/antigravity-awesome-skills/planning-with-files","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/planning-with-files","isPrimary":false,"firstSeenAt":"2026-04-18T21:42:27.384Z","lastSeenAt":"2026-04-23T00:51:23.907Z"}],"details":{"listingId":"f54e9bb2-8d77-45a3-9260-205a33c2e392","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"planning-with-files","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34616,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"81412f54b1e067cf3d4a7ccf962a7722e9d52ff2","skill_md_path":"skills/planning-with-files/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/planning-with-files"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"planning-with-files","description":"Work like Manus: Use persistent markdown files as your \"working memory on disk.\""},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/planning-with-files"},"updatedAt":"2026-04-23T00:51:23.907Z"}}