Agent skill · software engineering · aradotso
planning-with-files-manus-workflow
planning-with-files-manus-workflow — an agent skill for coding agents.
Why this skill is useful
Adds a structured markdown workflow for persistent planning that enhances task tracking and context management for AI coding agents.
What it needs
Requires npx installed locally. About 7k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Context Window = RAM (volatile, limited) Filesystem = Disk (persistent, unlimited) → Anything important gets written to disk immediately. bash npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g /plugin marketplace add OthmanAdi/planning-with-files /plugin install planning-with-files@planning-with-files bash cp -r ~/.claude/plugins/cache/planning-with-files/planning-with-files//skills/planning-with-files ~/.claude/skills/ powershell Copy-Item -Recurse -Path "$env:USERPROFILE\.claude\plugins\cache\planning-with-files\planning-with-files\\skills\planning-with-files" -Destination "$env:USERPROFILE\.claude\skills\" taskplan.md → Phases, goals, checkboxes, error log findings.md → Research results, discoveries, references progress.md → Session log, test results, current state markdown Task Plan: [Feature/Task Name] Goal [One-paragraph description of what done looks like] Phases Phase 1: Research & Setup [ ] Understand existing codebase structure [ ] Identify affected modules [ ] Check for related tests Phase 2: Implementation [ ] Create new module src/feature.py [ ] Update src/main.py to integrate feature [ ] Add error handling Phase 3: Testing & Validation [ ] Write unit tests [ ] Run full test suite [ ] Verify edge cases Current Status Active Phase: Phase 1 Last Updated: 2026-03-18 Errors & Blockers <!-- Log failures here so they aren't repeated --> [2026-03-18] Import error in utils.py — missing requests dep, fixed by adding to requirements.txt Notes API rate limit: 100 req/min Auth token stored in $APITOKEN env var markdown Findings: [Task Name] Architecture Notes Entry point: src/main.py:run() Config loaded from config/settings.yaml Database: PostgreSQL via SQLAlchemy ORM API Behaviour POST /api/v1/items returns 201 with {"id": "uuid", "status": "created"} Rate limit headers: X-RateLimit-Remaining, X-RateLimit-Reset Auth: Bearer token in Authorization header Key Files File Purpose ------ --------- src/models.py SQLAlchemy models src/api/client …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/planning-with-files-manus-workflow