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 +1 -1
- package/skills/README.md +1 -0
- package/skills/ghosty-factory/SKILL.md +101 -0
package/package.json
CHANGED
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).
|