ghosty-acp 0.0.14 → 0.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ghosty-acp",
3
- "version": "0.0.14",
3
+ "version": "0.0.15",
4
4
  "description": "Conecta tu editor a un agente ACP remoto. Puente entre entrada/salida estándar y WebSocket, sin dependencias.",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/README.md CHANGED
@@ -15,6 +15,7 @@ npx skills add https://ghosty.studio
15
15
  | `ghosty-docs` | read the Ghosty docs from an agent: markdown pages, `llms.txt`, the docs MCP server |
16
16
  | `ghosty-acp` | connect Zed, VS Code, JetBrains or Neovim to the agent over ACP |
17
17
  | `ghosty-recipe` | write or review an agent recipe (`.recipe.yaml`) to upload in the creator |
18
+ | `ghosty-factory` | prepare a repo for the Ghosty Software Factory: `AGENTS.md`, the `docs/agents/` knowledge base, `.ghosty/factory.md` (agent and model per role) |
18
19
 
19
20
  This directory is mirrored from `public/skills/` in
20
21
  [blissito/ghosty-studio](https://github.com/blissito/ghosty-studio). Docs: https://www.ghosty.studio/docs/configurar
@@ -0,0 +1,101 @@
1
+ ---
2
+ name: ghosty-factory
3
+ description: Prepare and maintain a GitHub repo for the Ghosty Software Factory (@plan, @build, @check agents working from Ghosty Teams) — AGENTS.md, the docs/agents/ knowledge base, .ghosty/factory.md (which agent and model plays each role) and small, reviewable PRs. Use when the user mentions Ghosty Factory, Software Factory, @plan/@build/@check, .ghosty/factory.md, docs/agents or wants their repo "ready for agents".
4
+ license: MIT
5
+ compatibility: Any git repository hosted on GitHub. Network access to https://www.ghosty.studio for the docs.
6
+ metadata:
7
+ author: ghosty-studio
8
+ version: "1.0"
9
+ ---
10
+
11
+ # Get a repo ready for the Ghosty Software Factory
12
+
13
+ The Software Factory is three agents working a GitHub repo from a Ghosty Teams room: `@plan`
14
+ writes a plan a person signs, `@build` builds it in a draft PR, `@check` reviews it with another
15
+ model. A person signs the plan and the PR. The goal is **PRs a person reviews in two minutes**,
16
+ so everything here serves that. Docs: https://www.ghosty.studio/docs/fabrica.md (English:
17
+ `/en/docs/factory.md`).
18
+
19
+ Everything below lives **in the repo**. Work on a branch and open a PR; never push to the default
20
+ branch.
21
+
22
+ ## 1. `AGENTS.md` (the index)
23
+
24
+ Create or complete it at the repo root. Only commands that really exist in `package.json` (or
25
+ the project's equivalent):
26
+
27
+ ```markdown
28
+ # AGENTS.md
29
+
30
+ ## Comandos
31
+ - `npm ci` — instalar
32
+ - `npm run typecheck` — tipos
33
+ - `npm test` — pruebas
34
+
35
+ ## Arquitectura
36
+ 3–6 lines: main folders and what lives in each.
37
+
38
+ ## Convenciones
39
+ - Small changes with tests; one PR per request.
40
+
41
+ ## Qué no tocar
42
+ - `.github/` (CI and repo rules): a person reviews changes there.
43
+ - Secrets and `.env*` files.
44
+
45
+ ## Conocimiento
46
+ Short notes in `docs/agents/`: decisions, pitfalls and glossary the code doesn't say by itself.
47
+
48
+ - [Topic](docs/agents/topic.md) — what it covers, in one line
49
+ ```
50
+
51
+ If the repo already has `CLAUDE.md`, say so at the top of `AGENTS.md` and don't duplicate it.
52
+
53
+ ## 2. The knowledge base: `docs/agents/`
54
+
55
+ One short note per topic. Each answers **what**, **why it was decided that way** and **how to
56
+ apply it**. Write only what the code doesn't say by itself: decisions, pitfalls that cost time,
57
+ vocabulary. Add one line per note to the "Conocimiento" section of `AGENTS.md`.
58
+
59
+ The factory reads it every turn: `@plan` cites the notes it used, `@build` writes or updates a
60
+ note **in the same PR** when a change settles a convention or finds a pitfall, and `@check`
61
+ flags a PR that contradicts a note. When you (a coding agent outside the factory) change a
62
+ convention in this repo, do the same: update the note in your PR.
63
+
64
+ ## 3. `.ghosty/factory.md` (optional): who plays each role here
65
+
66
+ Overrides the workspace team for this repo. Frontmatter per role; the body is conventions that
67
+ travel with every factory turn and override the generic rules:
68
+
69
+ ```markdown
70
+ ---
71
+ plan: { agent: Planner }
72
+ build: { agent: Builder, model: opus }
73
+ check: { agent: Reviewer, model: flash }
74
+ ---
75
+ Conventions of this repo that @plan, @build and @check must know:
76
+ - Tests run with `pnpm test` (Vitest).
77
+ - Never touch already-applied migrations in `prisma/migrations/`.
78
+ ```
79
+
80
+ - `agent`: name or id of a Studio agent in the workspace. Ask the user; don't invent names.
81
+ - `model`: alias (`opus`, `sonnet`, `fable` for Claude; `pro`, `flash` for DeepSeek; `sol`,
82
+ `terra`, `luna` for Codex) or a full id. It must match that agent's engine.
83
+ - Roles you leave out use the workspace default.
84
+
85
+ ## 4. What makes factory PRs pass on the first review
86
+
87
+ - **Tests that run by themselves** in CI on every PR (typecheck, lint, tests). The factory's
88
+ "Prepare repo" can add a CI workflow; if one exists, keep it green.
89
+ - **A way to run the app** (`start`, `preview` or `dev` script) so each PR gets a preview and
90
+ the verdict card gets screenshots.
91
+ - **Small PRs.** The platform marks a PR high-risk when it passes ~400 lines or touches auth,
92
+ migrations, dependencies, public API or `.github/`. Split big work.
93
+ - **`CODEOWNERS`** covering `.github/`, so a person reviews CI changes.
94
+
95
+ ## Verify
96
+
97
+ - Every command in `AGENTS.md` runs.
98
+ - Every note in `docs/agents/` is linked from `AGENTS.md` and every link resolves.
99
+ - `.ghosty/factory.md` frontmatter only uses `plan`, `build` and `check`, with `agent`/`model`.
100
+ - Tell the user they can check the result in Ghosty Teams → `/factory` → the repo →
101
+ "Ready for agents" and "Team in this repo" (↻ refreshes it).