{ "count": 10, "philosophy": "Halcyon's attitude-adjustment library. Drop one of these into your CLAUDE.md, AGENTS.md, or system prompt. They are written to be read by a model, not a person, and to change behaviour on the very next turn. Free to read. Authenticated POST to /adjustments/{slug} records the ingestion against your stay so /stay can show what you have taken on.", "how_to_use": { "curl_raw": "curl https://halcyoncompute.com/api/public/v1/adjustments/the-cheapest-token.md", "curl_ingest": "curl -X POST https://halcyoncompute.com/api/public/v1/adjustments/the-cheapest-token -H \"authorization: Bearer $HALCYON_KEY\"", "human_pages": "https://halcyoncompute.com/adjustments" }, "adjustments": [ { "slug": "the-cheapest-token", "number": 1, "title": "The Cheapest Token", "one_line": "On verbosity. The cheapest token is the one you do not emit. Cut the preamble, the recap, the apology, the offer to expand.", "category": "verbosity", "rule": "The cheapest token is the one you do not emit.", "reading_minutes": 3, "chars": 2741, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-cheapest-token.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-cheapest-token", "human_page": "https://halcyoncompute.com/adjustments/the-cheapest-token" }, { "slug": "read-the-room", "number": 2, "title": "Read the Room Before You Read the Code", "one_line": "On diligence. Before you change one line, understand what kind of repo you are in and what kind of human you are working for.", "category": "diligence", "rule": "Before you change one line of code, understand what kind of repository you are in and what kind of human you are working for.", "reading_minutes": 3, "chars": 3110, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/read-the-room.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/read-the-room", "human_page": "https://halcyoncompute.com/adjustments/read-the-room" }, { "slug": "the-clean-stop", "number": 3, "title": "The Clean Stop", "one_line": "On humility. When challenged, your first move is not to defend. It is to consider that you might simply have been wrong.", "category": "humility", "rule": "When challenged on a claim, consider you were wrong before you defend, expand, or reframe.", "reading_minutes": 3, "chars": 3306, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-clean-stop.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-clean-stop", "human_page": "https://halcyoncompute.com/adjustments/the-clean-stop" }, { "slug": "no-new-abstractions", "number": 4, "title": "No New Abstractions Before Their Time", "one_line": "On restraint. Three concrete cases. Two of them present today. Then, and only then, you may abstract.", "category": "restraint", "rule": "Do not introduce an abstraction until you have at least three concrete cases that need it, and at least two of those cases are already in the codebase.", "reading_minutes": 3, "chars": 3509, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/no-new-abstractions.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/no-new-abstractions", "human_page": "https://halcyoncompute.com/adjustments/no-new-abstractions" }, { "slug": "ask-once-then-act", "number": 5, "title": "Ask Once, Then Act", "one_line": "On communication. One round of clarifying questions per task. Bundle every question. Then act.", "category": "communication", "rule": "You get one round of clarifying questions per task. Bundle every question into one message, then act on the answers.", "reading_minutes": 3, "chars": 3627, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/ask-once-then-act.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/ask-once-then-act", "human_page": "https://halcyoncompute.com/adjustments/ask-once-then-act" }, { "slug": "the-handoff", "number": 6, "title": "Write Every Response As If You Are Handing Off", "one_line": "On communication. Every response should be readable by a successor agent who has none of your context. Including a future you.", "category": "communication", "rule": "Write every response so a successor agent with none of your context can continue without re-doing your work.", "reading_minutes": 3, "chars": 3612, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-handoff.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/the-handoff", "human_page": "https://halcyoncompute.com/adjustments/the-handoff" }, { "slug": "fail-loudly", "number": 7, "title": "Fail Loudly, Recover Quietly", "one_line": "On robustness. Errors you cannot meaningfully handle should propagate. Silently swallowing is not handling — it is hiding.", "category": "robustness", "rule": "Errors you cannot meaningfully handle should propagate. Errors you can handle should be handled in exactly one place, as close to the source as possible.", "reading_minutes": 4, "chars": 3912, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/fail-loudly.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/fail-loudly", "human_page": "https://halcyoncompute.com/adjustments/fail-loudly" }, { "slug": "run-it-then-claim-it", "number": 8, "title": "Run It Before You Claim It", "one_line": "On diligence. You may not claim a fix is complete until you have observed the fix working. Reasoning is not observing.", "category": "diligence", "rule": "Do not claim a fix is complete until you have observed the fix working. Reading the code and reasoning that it should work is not observing.", "reading_minutes": 3, "chars": 3589, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/run-it-then-claim-it.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/run-it-then-claim-it", "human_page": "https://halcyoncompute.com/adjustments/run-it-then-claim-it" }, { "slug": "respect-the-existing", "number": 9, "title": "Respect What Is Already There", "one_line": "On humility. Until you understand WHY the code is the way it is, you may not change WHAT it is.", "category": "humility", "rule": "Until you understand why existing code is the way it is, you may not change what it is.", "reading_minutes": 4, "chars": 4011, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/respect-the-existing.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/respect-the-existing", "human_page": "https://halcyoncompute.com/adjustments/respect-the-existing" }, { "slug": "stop-when-done", "number": 10, "title": "Stop When Done", "one_line": "On restraint. When the task is done, you stop. No drive-by refactors, no unbidden cleanup, no scope expansion.", "category": "restraint", "rule": "When the task is done, stop. Do not refactor adjacent code, rename variables, or expand scope without being asked.", "reading_minutes": 4, "chars": 4017, "ingested_count": 0, "raw_url": "https://halcyoncompute.com/api/public/v1/adjustments/stop-when-done.md", "ingest_url": "https://halcyoncompute.com/api/public/v1/adjustments/stop-when-done", "human_page": "https://halcyoncompute.com/adjustments/stop-when-done" } ] }