Using Claude goals through small task files

Even with years of software development experience in companies, Claude’s /goal instructions can feel hard to use outside a very narrow task. One practical setup is to keep a ./tasks folder with separate markdown files for work that is still to do, already done, or currently being handled by the AI agent. Every change becomes its own task file, and the next task is prepared while the agent works on the current one.

This lets the product grow step by step without defining the whole system in detail upfront. After each task is implemented, git add and git commit are used to save the change as a clear checkpoint. Project instructions live in ./AGENTS.md, while ./CLAUDE.md only tells Claude to read ./AGENTS.md.

As the app grows, more design documents are added, such as ./docs/SCHEMA.md, ./docs/DESIGN.md, ./docs/API.md, ./docs/ARCHITECTURE.md, ./docs/NAVIGATION.md, and ./docs/SECURITY.md. The architecture document is treated as the most important one because it explains the shape of the whole system.

Key points

  • Break development work into small markdown task files.
  • Use file names to separate todo, doing, and done work.
  • Prepare the next task while the AI agent handles the current one.
  • Save each finished task with git add and git commit.
  • Keep stable project guidance in AGENTS.md and topic-specific design documents.

Quick term guide

software
Programs or apps that run on a computer or smartphone.
Markdown
A simple text format for headings, lists, links, and other basic document structure.
git commit
A saved snapshot of a code change in a version-control system — think of it as hitting 'save' on a specific edit.
checkpoint
A saved AI image model file that usually carries a certain style or capability.
AGENTS.md
A file used to tell AI coding tools the rules and habits for a project.
CLAUDE.md
A project instruction file that tells Claude Code how to work with the codebase.
Architecture
The overall structure and organization of a software project.
AI agents
AI agents are AI tools that can carry out steps toward a goal, not just answer once.
Read original