aeopress

Saygoal.TW

Name: Saygoal.TW
Author: aeopress

AI community

SOURCE https://github.com/aeopress/saygoal.TW

Description

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

saygoal

**say a goal, watch it get done** — a declarative `/dec` + `/goal` workflow for Claude Code & Codex, in the spirit of Karpathy's "give it success criteria and watch it go".

![/dec — Imperative to Declarative](./saygoal.TW.png)

English | [繁體中文（台灣）](./README.zh-TW.md) | [简体中文](./README.zh-CN.md) | [日本語](./README.ja.md)

**Source of truth**: [`aeopress/saygoal.TW`](https://github.com/aeopress/saygoal.TW) (formerly maintained at [`yelban/andrej-karpathy-skills.TW`](https://github.com/yelban/andrej-karpathy-skills.TW), now archived)

What it does

`saygoal` turns a vague, imperative request into a **verifiable contract**, then lets the agent loop until that contract is met:

/dec rewrites your task into success criteria + a verification command + boundaries, and emits a ready-to-paste /goal condition.
Paste that into Claude Code's (or Codex's) built-in /goal — a small fast model checks the transcript after each turn and keeps the agent working until the condition holds.
/saygoal:retro — when a /goal loop stalls, reads the transcript as a search trace, diagnoses why, and structurally rewrites the contract (revised condition + a rollback line).
/saygoal:judge — the acceptance gate: treats any "done" as a set of claims, re-runs the contract's verification itself, audits the diff against the verification surface, and returns VERIFIED / VERIFIED WITH CAVEATS / REFUTED.

**30-second example:**

/dec fix the login flicker on first load

→ /goal "run npx playwright test login-flicker.spec.ts until it paste-shows 0 failures
         without changing the auth flow or any file outside the login component
         or stop after 12 turns"

`/dec` writes the contract; `/goal` drives to green. Works on **Claude Code** (`/dec` command) and **OpenAI Codex** (`$dec` skill — seven-field format).

→ [Install](#install) · [How it works](#dec--goal--the-pipeline) · [Why the rules file isn't the leverage](#why-the-r