Scriptonia/blog
DocsGet Scriptonia
— BLOG

Grounding coding agents in customer reality.

Notes on agent product memory, PLAN.md, and the issue → PR loop — from the team building Scriptonia.

CATEGORY2026-07-01 · 5 min
What is agent product memory?

Agent product memory is a persistent, queryable store of what your customers actually asked for — Slack threads, tickets, sales calls, decisions — structured so a coding agent can ground its work in it. Your agent already knows your code; product memory gives it your customers.

Read →
WORKFLOW2026-07-02 · 6 min
Issue → PR: making coding agents build what customers actually asked for

The reliable way to go from a customer issue to a merged PR with a coding agent is a grounded plan file: retrieve the real customer signal behind the issue, check it against prior decisions, write PLAN.md with cited evidence and explicit non-goals, then have the agent execute that file verbatim.

Read →
FORMAT2026-07-03 · 5 min
PLAN.md: a spec format coding agents can actually execute

PLAN.md is a one-page markdown spec with YAML frontmatter and seven fixed sections — Goal, Evidence, Constraints, Non-goals, Acceptance criteria, Implementation steps, Test plan. It works because agents execute fenced, cited, self-contained instructions far more faithfully than prose briefs.

Read →
PRACTICE2026-07-04 · 4 min
How to stop your coding agent from over-building

Coding agents over-build because prompts state the goal but not the boundary. The fix is structural, not better prompting: give the agent a plan with an explicit Non-goals fence, cited acceptance criteria, and a hard gate on anything that contradicts a prior decision.

Read →
TUTORIAL2026-07-05 · 4 min
How to give Claude Code a product brain in 5 minutes

To give Claude Code a product brain, install Scriptonia with npx scriptonia login, feed it customer signal with scriptonia add, and generate plans with scriptonia plan. A skill and AGENTS.md are wired automatically, so Claude Code grounds its work in real customer signal from then on.

Read →
CATEGORY2026-07-05 · 5 min
Product memory vs. conversation memory: the category split

Conversation memory (Mem0, Zep) helps an agent remember its chats with you. Product memory helps a coding agent know what your customers asked for and what your team already decided. They solve different problems: one makes agents more personal, the other makes them ship the right thing.

Read →
STORY2026-07-05 · 4 min
The 2:47 AM note problem

Founders lose their sharpest product insights because they arrive at the wrong time: 2:47 AM notes, hallway remarks, one line in a sales call. The fix isn't discipline, it's a capture path with zero friction that feeds directly into what gets built: pipe the note into product memory, and it resurfaces cited in the next plan.

Read →