The Agent Skills Directory

[Persistent State Management]: The skill defines a methodical approach to tracking progress by writing data to the .agent_cache/ directory. This uses local filesystem operations to ensure the agent maintains context across long-running tasks and multiple tool calls.
[Command Usage]: Standard shell utilities like mkdir and mv are used for organizational purposes. These commands are executed within the local project environment to manage the lifecycle of the planning files.
[Context Ingestion Pattern]: The agent's workflow involves reading back planning files that may contain data aggregated from external documentation or research. While this is an intended part of the state-tracking mechanism, it represents a surface where the agent processes previously gathered information.
Ingestion points: The workflow in SKILL.md includes reading the task_plan.md file at the beginning of the agent loop.
Boundary markers: The planning files use standard Markdown headers for structure, providing logical separation between different sections of the plan and findings.
Capability inventory: The skill utilizes basic file management commands and assumes access to standard development tools such as linters and test runners.
Sanitization: Task-related content is recorded and processed in Markdown format as part of the agent's internal reasoning and tracking logic.

planning-with-files