{"id":"othmanadi-planning-with-files","name":"planning-with-files","homepage":null,"repo_url":"https://github.com/OthmanAdi/planning-with-files","category":"devtools","subcategories":[],"tags":["agent-skills","planning","productivity","claude-code","cursor","persistent-memory","hooks","markdown","devtools","python","local-files"],"what_it_does":"A skill/plugin that turns an AI coding/planning agent workflow into a persistent, file-based system (Manus-style). It creates and maintains markdown planning/progress files (e.g., task_plan.md, findings.md, progress.md) and uses IDE/agent hooks to re-read the plan before actions, remind progress updates after tool use, log errors, and verify completion before stopping.","use_cases":["Long-running coding projects where the agent needs durable working memory (plans, checkpoints, findings).","Reducing goal drift by re-reading a persisted plan before key decisions.","Capturing tool failures/errors in a persistent log for later correction.","Multi-step research + implementation workflows where findings must persist across context resets.","Autocomplete/command-driven planning in Claude Code and compatible agent/IDE skill frameworks."],"not_for":["Projects that cannot write to the local filesystem or where persistent workspace changes are disallowed.","Use cases requiring a centralized hosted API service (this is a local/IDE skill).","Scenarios needing strict transactional semantics or database-backed consistency guarantees."],"best_when":"You have an agent running in an IDE with support for “skills”/hooks and you can persist markdown files in a project directory.","avoid_when":"You cannot persist files locally, or you want a purely stateless agent interaction without lifecycle hooks.","alternatives":["Manus-style manual persistent planning templates (user-created markdown files + prompts).","Other Agent Skills that implement planning/progress tracking, if available for your specific IDE/agent framework.","Custom scripts/macros that generate and update a planning markdown bundle (task_plan/findings/progress) without hook automation."],"af_score":58.2,"security_score":11.8,"reliability_score":50.8,"package_type":"skill","discovery_source":["openclaw"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-29T13:16:45.319372+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No service authentication described; it operates as an IDE/agent skill that reads/writes local project files and configures IDE hooks."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Repository README does not indicate any paid tier/pricing for the skill itself."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":58.2,"security_score":11.8,"reliability_score":50.8,"mcp_server_quality":0.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":0.0,"auth_strength":10.0,"scope_granularity":0.0,"dependency_hygiene":35.0,"secret_handling":20.0,"security_notes":"No network service is described, so TLS/auth are not central. However, the skill uses hooks and writes/reads local files; risk is primarily from local data handling (e.g., path sanitization and content injection mentioned in release notes) and from any dependencies/hooks execution model. No concrete details are provided in the provided README about dependency scanning, CVEs, or secret redaction.","uptime_documented":0.0,"version_stability":78.0,"breaking_changes_history":65.0,"error_recovery":60.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Relies on IDE/agent hook support; behavior may differ across platforms depending on hook availability and correctness.","Because it uses filesystem persistence, ensure the agent has appropriate write access to the project directory and that concurrent runs don’t conflict on the same planning files.","When using session recovery/clear, automation may attempt to reconstruct context—verify the catchup report before trusting it for subsequent decisions."]}}