Skip to main content

​
LLM workflows with BlocPad CLI

Use BlocPad CLI as your source of truth for tasks and context, then use an LLM to implement changes in your repository.

​
Security rule

Never paste your bp_pat_... token into any LLM or CLI tool.

​
The basic loop

  1. Pick a task (or parent task).
  2. Export the context as Markdown.
  3. Give the context + instructions to your LLM.
  4. Apply changes locally and run checks.
  5. Mark the task done via proposals: blocpad propose task status --status done --task-number <N> then blocpad apply --yes.
After finishing a task, ask your agent to suggest the next best leaf task and include the exact blocpad command to fetch it (for example: blocpad tasks next <TASK> --json then blocpad tasks focus <TASK> --md). For Traditional PM projects, the agent can also orient itself with blocpad pm tree --json to see the full Goals → Epics → Stories → Tasks hierarchy. Single task:
If ERS-1 has subtasks, export the next suggested leaf subtask:
Save context to a file (easy to attach/paste):

​
Prompt template (copy/paste)

​
Tool-specific guides (CLI)

​
Where to put rules

  • Cursor: .cursorrules
  • Codex CLI: AGENTS.md
  • Claude CLI: .claude/config.json
  • GitHub Copilot CLI: .github/copilot-instructions.md