agentic-retro 0.1.0 → 0.1.1

package/README.md

@@ -86,6 +86,7 @@ Using Codex? It asks you to trust the new session-end hook the first time a sess
 
 ## CLI commands
 
+- `agentic-retro about` – print a short intro to what agentic-retro does
 - `agentic-retro setup` – interactive config, the human alternative to the setup skill
 - `agentic-retro config list | get <key> | set <key> <value>` – read or write one config key
 - `agentic-retro enqueue` – add a finished session to the queue (hooks call this)

package/cli/agentic-retro.js

@@ -10,8 +10,10 @@ import { syncOutcomes } from './lib/outcomes.js';
 import { notice } from './lib/notice.js';
 import { stats } from './lib/stats.js';
 import { installPi } from './lib/pi.js';
+import { INTRO } from './lib/intro.js';
 
 const USAGE = `usage: agentic-retro <command>
+  about
   setup
   config list | get <key> | set <key> <value>
   enqueue [--harness <h>] [--session <id> --transcript <path> --cwd <dir>]   (or hook JSON on stdin)
@@ -76,6 +78,7 @@ async function main() {
   if (command === 'notice') return notice(flags);
   if (command === 'stats') return stats(flags);
   if (command === 'install-pi') return installPi();
+  if (command === 'about') return process.stdout.write(INTRO);
   throw new Error(USAGE);
 }
 

package/cli/lib/intro.js

@@ -0,0 +1,6 @@
+// The one-screen intro shown before setup asks anything. The setup skill prints it too, via `agentic-retro about`.
+export const INTRO = `agentic-retro reviews your finished coding-agent sessions in batches and suggests improvements.
+- It looks for code that could be clearer, agent setup (skills, instructions) that would have saved time, and repo changes that help agents work faster
+- You get one pull request per repo, or a report you walk through with your agent
+- Nothing lands without your review, unless you turn on auto-merge for low-risk changes
+`;

package/cli/lib/setup.js

@@ -3,6 +3,7 @@ import { createInterface } from 'node:readline';
 import { existsSync } from 'node:fs';
 import { delimiter, join } from 'node:path';
 import { loadConfig, saveConfig, getKey, parseValue } from './config.js';
+import { INTRO } from './intro.js';
 
 const onPath = (bin) => (process.env.PATH || '').split(delimiter).some((dir) => existsSync(join(dir, bin)));
 
@@ -34,6 +35,7 @@ export async function setup() {
   const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
   const lines = rl[Symbol.asyncIterator]();
   const config = loadConfig();
+  process.stdout.write(`${INTRO}\nThese questions take about two minutes. Press Enter to keep the value in brackets.\n\n`);
 
   for (const [key, label, presets] of questions()) {
     const current = show(getKey(config, key));

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "agentic-retro",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "agentic-retrospective: reviews finished agent coding sessions and proposes improvements",
   "type": "module",
-  "bin": { "agentic-retro": "cli/agentic-retro.js" },
-  "files": ["cli/", "skills/"],
-  "engines": { "node": ">=20" },
-  "scripts": { "test": "node --test test/*.test.js" },
+  "bin": {
+    "agentic-retro": "cli/agentic-retro.js"
+  },
+  "files": [
+    "cli/",
+    "skills/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
   "license": "MIT",
-  "repository": "github:ac8318740/agentic-retro"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ac8318740/agentic-retro.git"
+  }
 }

package/skills/run/agent-setup.md

@@ -41,7 +41,7 @@ Every agent-setup proposal carries a risk label.
 ## Where a change may go
 
 - **New things** go under `targets.preset`, such as `~/.claude/skills`
-    - `targets.note` may name another place, such as "send spechub fixes to the spechub repo at <path>"
+    - `targets.note` may name another place, such as "send acme-skills fixes to its repo at <path>"
     - Follow the note when it covers the finding
 - **Edits to existing files** go only under a path listed in `editable`
     - Drop a finding against a file outside `editable`, however good it is

package/skills/setup/SKILL.md

@@ -12,6 +12,10 @@ Walk the user through agentic-retro's config, one question at a time, then write
 1. Run `command -v agentic-retro`.
 2. If the command is missing, tell the user to run `npm install -g agentic-retro`, then stop.
 
+## Open with the intro
+
+Run `agentic-retro about` and show its output to the user as is, before the first question. It says what agentic-retro does in a few lines. Add nothing to it.
+
 ## Ask each question
 
 Use the host's question tool (for example `AskUserQuestion`) when one is available. Otherwise ask in plain chat, one question at a time.
@@ -32,7 +36,7 @@ Offer the presets below for each question, and let the user type a different ans
 9. **Auto-merge** – merge low-risk agent-setup PRs automatically? Default off
 10. **Expire after** – batches an open proposal waits before it expires with no action, default 3
 11. **Targets** – where agent-setup proposals go: `~/.claude/skills`, `~/.codex/skills`, or a plugin repo path
-    - Also ask for a free-text note the batch agent reads, for example: "I develop spechub; send spechub fixes to the spechub repo at ~/spechub"
+    - Also ask for a free-text note the batch agent reads, for example: "I maintain the acme-skills plugin; send fixes to its repo at ~/code/acme-skills"
 12. **Editable paths** – which paths proposals can write to, as a JSON list; every other path stays read-only
 13. **Notes** – free text, anything else the batch agents should know
 
@@ -52,7 +56,7 @@ agentic-retro config set output pr
 agentic-retro config set autoMergeLowRisk false
 agentic-retro config set expireAfterBatches 3
 agentic-retro config set targets.preset ~/.claude/skills
-agentic-retro config set targets.note "I develop spechub; send spechub fixes to ~/spechub"
+agentic-retro config set targets.note "I maintain the acme-skills plugin; send fixes to its repo at ~/code/acme-skills"
 agentic-retro config set editable '["~/.claude/skills"]'
 agentic-retro config set notes "ask about this"
 ```