Skip to content

Commit 71ff7cf

Browse files
committed
docs: add v0.1 changelog and expand techniques with tool implementations
1 parent c3554e5 commit 71ff7cf

File tree

2 files changed

+124
-4
lines changed

2 files changed

+124
-4
lines changed

CHANGELOG.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,28 @@
22

33
All notable changes to the Coding with AI techniques collection are documented here.
44

5+
## September 16, 2025 - v0.1
6+
7+
### Added
8+
- "Choose the Right Model for the Job" technique with tool implementations for Claude Code and Codex CLI
9+
- "Plan with High-Capacity Mode" technique for using higher-capability models during planning phase
10+
- "Create Rollback Points While Coding" technique with tool implementations for checkpoint management
11+
- "Ask for ASCII Wireframes" technique for UI layout planning
12+
- "Confirm Understanding Before Coding" technique for task alignment
13+
- Tool implementations for "Ask to Plan First" technique (Claude Code, Cursor, Codex CLI)
14+
- Changelog update instruction in AGENTS.md for future maintenance
15+
16+
### Changed
17+
- Replaced "Ask to Think First" with "Ask to Plan First" technique with updated content and tool implementations
18+
- Enhanced technique organization with expanded tool implementation details
19+
- Updated active development dates across all language translations
20+
- Refreshed project documentation and configuration
21+
- Removed outdated "latest update" references
22+
23+
### Fixed
24+
- Contributing guidelines updated with clearer instructions
25+
- Improved technique visibility and accessibility
26+
527
## September 5, 2025
628

729
### Added

README.md

Lines changed: 102 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -114,12 +114,55 @@ Deliberately pick well-established libraries with good stability that existed be
114114
> "I gain enough value from LLMs that I now deliberately consider this when picking a library—I try to stick with libraries with good stability and that are popular enough that many examples of them will have made it into the training data. I like applying the principles of boring technology—innovate on your project's unique selling points, stick with tried and tested solutions for everything else."
115115
> [Simon Willison](https://simonwillison.net/2025/Mar/11/using-llms-for-code/#:~:text=I%20gain%20enough%20value%20from%20LLMs)
116116
117-
### Ask to Think First
117+
### Ask to Plan First
118118

119-
Use `think` or `think hard` to trigger more careful planning before coding.
119+
Tell the assistant to outline steps, risks, and quick tests before touching code so you can review and adjust the approach.
120120

121-
> "Claude tends to jump straight into implementation without sufficient background, which generates poor quality results. Another tactic for priming the agent is asking Claude to use its extended thinking mode and make a plan first. The extended thinking is activated by this set of magic keywords: `think` < `think hard` < `think harder` < `ultrathink.` These are not just suggestions to the model—they are specific phrases that activate various levels of extended thinking."
122-
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=Claude%20tends%20to%20jump%20straight)
121+
> "If you want to iterate on the plan, it helps to explicitly include instructions in the prompt to not proceed with implementation until the plan has been accepted by the user."
122+
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=If%20you%20want%20to%20iterate%20on%20the%20plan)
123+
124+
**Tool Implementations:**
125+
126+
<details>
127+
<summary><strong>Claude Code</strong></summary>
128+
129+
Hit `Shift+Tab` to drop into Plan Mode so it only reads and drafts. Use the shared planning prompt, iterate until it looks right, then exit Plan Mode when you green-light implementation.
130+
131+
</details>
132+
133+
<details>
134+
<summary><strong>Cursor</strong></summary>
135+
136+
Click the Plan toggle in Cursor so it stays read-only while you iterate. Have it list steps, impacted files, risks, and quick tests, then exit Plan Mode to open the diff once you green-light implementation.
137+
138+
</details>
139+
140+
<details>
141+
<summary><strong>Codex CLI</strong></summary>
142+
143+
Remind Codex to keep planning separate from implementation: list steps, risks, and quick tests, pause for your review, then let it implement and inspect the diff once approved.
144+
145+
</details>
146+
147+
### Plan with High-Capacity Mode
148+
149+
When gathering requirements or drafting specs, temporarily switch to a higher-capability model or extended reasoning mode so it can read, synthesize, and propose a plan before coding.
150+
151+
**Tool Implementations:**
152+
153+
<details>
154+
<summary><strong>Claude Code</strong></summary>
155+
156+
Run `/model` and pick `opus` (or another higher tier) when scoping requirements so it can reason deeply, then use Plan Mode if you want it to stay read-only until you approve edits.
157+
158+
</details>
159+
160+
<details>
161+
<summary><strong>Codex CLI</strong></summary>
162+
163+
Use `/model gpt-5-high` (or another extended-reasoning tier) to have the assistant digest context and draft the spec, then step back down once the plan is locked.
164+
165+
</details>
123166

124167
## UI & Prototyping
125168

@@ -154,8 +197,16 @@ Just ask to make the UI `more beautiful` or `more elegant` - it works.
154197
> "If Claude doesn't produce a well-designed UI the first time, you can just tell it to `make it more beautiful/elegant/usable`."
155198
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=If%20Claude%20doesn't%20produce)
156199
200+
### Ask for ASCII Wireframes
201+
202+
When refining layouts, have the assistant sketch ASCII wireframes so you can evaluate hierarchy and spacing before touching CSS.
203+
157204
## Coding
158205

206+
### Confirm Understanding Before Coding
207+
208+
Explicitly ask the tool to confirm its understanding of the task before starting implementation to ensure alignment and reduce mismatched expectations.
209+
159210
### Generate Code, Not Dependencies
160211

161212
Write custom code rather than pulling in more libraries when working with assistants.
@@ -272,6 +323,26 @@ Review changes in diff view and type corrections directly into the diff before c
272323
273324
## Cross-Stage Techniques
274325

326+
### Choose the Right Model for the Job
327+
328+
Before starting a new task, choose two levers: the right model (modality, context length, tool-calling reliability, latency, cost) and the right reasoning level (allocate more/less thinking tokens) — don't default blindly.
329+
330+
**Tool Implementations:**
331+
332+
<details>
333+
<summary><strong>Claude Code</strong></summary>
334+
335+
Two levers at task start: (1) Model via `/model` (fast/cheap for routine edits; long‑context for multi‑file/long docs; vision‑strong for UI/screenshots). (2) Reasoning level: enable extended thinking when tackling complex debugging, architecture, or ambiguous specs to allocate more reasoning tokens.
336+
337+
</details>
338+
339+
<details>
340+
<summary><strong>Codex CLI</strong></summary>
341+
342+
Start with `gpt-5-minimal`/`gpt-5-low` for quick edits; choose a higher‑reasoning variant `gpt-5-high`/`gpt-5-medium` when complexity rises.
343+
344+
</details>
345+
275346
### Run Multiple Agents in Parallel
276347

277348
Stop waiting for one AI agent to finish before starting another - run multiple agents in parallel on separate features without conflicts or confusion.
@@ -430,3 +501,30 @@ Collaborate like with a coding partner - explain problems, get feedback, and wor
430501

431502
> "Claude Code feels like pairing with someone with a few years under their belt who just needs the occasional nudge. Then like with pairing, it's review, refactor and test time because it's still your name on the git commit."
432503
> [Orta Therox](https://blog.puzzmo.com/posts/2025/06/07/orta-on-claude/#:~:text=Claude%20Code%20feels%20like%20pairing)
504+
505+
### Create Rollback Points While Coding
506+
507+
Create checkpoints you can revert to when experiments fail—capture known‑good working states before risky changes.
508+
509+
**Tool Implementations:**
510+
511+
<details>
512+
<summary><strong>Claude Code</strong></summary>
513+
514+
Use `git commit` frequently to create rollback points. Commit working code before risky changes so you can revert with `git reset` or branch switches.
515+
516+
</details>
517+
518+
<details>
519+
<summary><strong>Cursor</strong></summary>
520+
521+
Rely on Cursor's AI edit checkpoints (Cmd/Ctrl+Z) for quick undo; still create git commits for durable rollback points.
522+
523+
</details>
524+
525+
<details>
526+
<summary><strong>Codex CLI</strong></summary>
527+
528+
Commit working states as checkpoints before letting Codex apply large patches; revert with git if outcomes aren't good.
529+
530+
</details>

0 commit comments

Comments
 (0)