Skip to content

Commit 8b460ba

Browse files
committed
Integrate <Steps> component into "Prompting Techniques" documentation
1 parent 38e15a9 commit 8b460ba

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

src/content/docs/becoming-productive/prompting-techniques.md renamed to src/content/docs/becoming-productive/prompting-techniques.mdx

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
title: Prompting Techniques
33
---
44

5+
import { Steps } from "@astrojs/starlight/components";
6+
57
## A good thread structure
68

79
If you want a baseline for what decent threads for non-trivial tasks should look like, try this framework.
@@ -10,15 +12,19 @@ If you want a baseline for what decent threads for non-trivial tasks should look
1012
This is not a strict scheme you must follow exactly. Phases can be optional or merged. This can all be done in a single thread or in many smaller ones, with past thread references (e.g., `@Past Chat` in Cursor, `@@` in Amp), intermediary Markdown files, or a harness’s handoff feature as means of carrying valuable information.
1113
:::
1214

15+
<Steps>
16+
1317
1. **Brainstorm** - converse with an agent about how a task (or a part of it) can be done. The goal here is to gather information and collect it in one place. You can run several brainstorming sessions at once and produce summary `*.md` files as outcomes.
1418
2. **Plan** - go into _plan_ mode and work out a good implementation outline with an agent. Talk to it and refine the plan until it’s 👌
1519
3. **Execute** - when your agent (not you!) knows how the task should be done, tell it to do it!
1620
4. **Agent review** - many harnesses have built-in auto-review features. Try using them in the background so the agent spends time finding all the stupid mistakes, not you (you should be doing more valuable work in the meantime).
1721
5. **Human review** - ultimately, you (a human) are responsible for the code. Invest some time in reviewing it so that (a) you know what’s happening and (b) you won’t waste reviewers’ time.
1822
6. **Agent self-improvement** - talk to your agent: How can you both improve your workflow? What lessons can you learn from recent work? Perhaps some AGENTS.md rule or a new skill needs to be created?
19-
1. _If you use Claude Code, try the `/insights` command._
20-
2. _Use your harness's memory feature (e.g., `/memory` in Claude Code, Memories in Cursor) to persist lessons learned across sessions._
21-
3. _Try post-mortem diffs: ask the agent to compare its first attempt vs the final version and explain what it got wrong. Great for spotting recurring antipatterns._
23+
- _If you use Claude Code, try the `/insights` command._
24+
- _Use your harness's memory feature (e.g., `/memory` in Claude Code, Memories in Cursor) to persist lessons learned across sessions._
25+
- _Try post-mortem diffs: ask the agent to compare its first attempt vs the final version and explain what it got wrong. Great for spotting recurring antipatterns._
26+
27+
</Steps>
2228

2329
## Red/green TDD
2430

0 commit comments

Comments
 (0)