Compétences planning-with-files
📦

planning-with-files

Sûr ⚙️ Commandes externes

Plan Complex Tasks with Persistent Files

Également disponible depuis: ZhanlinCui,AmmarCodes,OthmanAdi

Long AI sessions cause context loss and forgotten goals. This skill uses markdown files as external memory to maintain task state across unlimited tool calls.

Prend en charge: Claude Codex Code(CC)
🥈 79 Argent
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "planning-with-files". Initialize planning for a Python CLI todo app with add, list, and delete commands

Résultat attendu:

  • Created task_plan.md with 5 phases: Requirements, Planning, Implementation, Testing, Delivery
  • Created findings.md with sections for requirements, research, and technical decisions
  • Created progress.md with session timestamp and initial status

Utilisation de "planning-with-files". Log error: FileNotFoundError when reading config.json

Résultat attendu:

  • Added to Errors Encountered table: FileNotFoundError, Attempt 1, Resolution: Create default config file
  • Updated progress.md error log with timestamp
  • Phase status remains in_progress until error resolved

Audit de sécurité

Sûr
v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

8
Fichiers analysés
1,146
Lignes analysées
1
résultats
1
Total des audits

Facteurs de risque

Audité par: claude

Score de qualité

59
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Multi-Step Development Projects

Track complex coding tasks across 50+ tool calls with phase tracking, error logging, and decision documentation.

Research and Documentation

Capture web search findings, browser results, and source materials in structured markdown before context is lost.

System Exploration and Debugging

Document discoveries, failed attempts, and resolutions when exploring unfamiliar codebases or debugging issues.

Essayez ces prompts

Initialize Planning Session
Create task_plan.md, findings.md, and progress.md files in my project directory. The goal is: [describe your task goal]. Start with Phase 1 for requirements gathering.
Track Bug Fix Progress
Read task_plan.md and update the current phase status. Log the error encountered: [paste error]. Document the root cause and attempted fixes in the Errors Encountered table.
Capture Research Findings
I just completed two web searches on [topic]. Update findings.md with the key discoveries, relevant URLs, and any technical decisions made based on this research.
Phase Completion and Review
Mark Phase [X] as complete in task_plan.md. Summarize what was accomplished, files created or modified, and update progress.md with test results. Then set Phase [X+1] to in_progress.

Bonnes pratiques

  • Create all three planning files before starting any complex task with 3+ steps
  • Read task_plan.md before making major decisions to keep goals in attention
  • Update findings.md immediately after every 2 view or browser operations
  • Log every error encountered, even if quickly resolved, to prevent repetition
  • Mark phase status changes explicitly: pending to in_progress to complete

Éviter

  • Starting execution without creating a task_plan.md file first
  • Silently retrying failed actions without logging the error
  • Repeating the same failing action instead of mutating approach
  • Creating planning files in the skill directory instead of project directory
  • Using TodoWrite for persistence instead of file-based storage

Foire aux questions

Where should I create the planning files?
Create task_plan.md, findings.md, and progress.md in your project directory where you are working, not in the skill installation folder. This keeps planning files alongside your code.
When should I update the planning files?
Update task_plan.md after each phase completes. Update findings.md after every 2 view or browser operations. Update progress.md throughout the session as actions are completed.
What is the 2-Action Rule?
After every 2 view, browser, or search operations, immediately write key findings to findings.md. This prevents visual or multimodal information from being lost when context resets.
How do I handle errors with this skill?
Log every error in the Errors Encountered table with attempt number and resolution. Never repeat the same failing action. After 3 failed attempts, escalate to the user with what you tried.
Can I use this for simple tasks?
For simple questions, single-file edits, or quick lookups, skip the planning files. Use this pattern for tasks with 3+ steps, research projects, or anything requiring organization across many tool calls.
What are the shell scripts for?
init-session.sh creates all three planning files with template content. check-complete.sh verifies all phases in task_plan.md are marked complete. Both are optional helpers for automation.

Détails du développeur

Structure de fichiers