open source is social v-it.org
Add init and adopt verbs to terminology docs
+47
-1
+4
-1
README.md
+4
-1
README.md
···
19
19
## Terminology
20
20
21
21
- **beacon** — a git repo that uniquely represents a project for all vit users; all project groupings are based on a single beacon (one unified "upstream"); git urls are canonicalized into a uniform beacon; stored in `.vit/`
22
+
- **init** — check environment readiness and configure vit for first use; alias: `doctor`
23
+
- **adopt** — adopt an existing project by its beacon; forks or clones the repo
22
24
- **follow** — atproto handles; stored in local project `.vit/`
23
25
- **skim** — check follows + beacon for posts; read the feed
26
+
- **vet** — run local evaluation and generate evidence for a cap
27
+
- **vouch** — publicly endorse a vetted cap, optionally attaching evidence
24
28
- **remix** — mix a post with local codebase and create a plan to implement; auto-likes
25
29
- **ship** — take any locally implemented feature and write up a post (or quote post if was remixed)
26
-
- **curate** — vet/validate posts to repost them
27
30
28
31
## oauth
29
32
+43
VOCAB.md
+43
VOCAB.md
···
77
77
78
78
## Core Verbs (CLI Surface)
79
79
80
+
### init
81
+
82
+
Check environment readiness and configure vit for first use.
83
+
84
+
```bash
85
+
vit init
86
+
vit doctor
87
+
```
88
+
89
+
`doctor` is an alias for `init`.
90
+
91
+
Capabilities:
92
+
- Log in to Bluesky (invokes OAuth flow)
93
+
- Install skills (agent capabilities)
94
+
- Initialize `.vit/` in the current git repo
95
+
- Verify environment is correctly configured
96
+
97
+
Init is the entry point for new users.
98
+
99
+
### adopt
100
+
101
+
Adopt an existing project by its beacon.
102
+
103
+
```bash
104
+
vit adopt <beacon>
105
+
```
106
+
107
+
Behavior:
108
+
- Forks via `gh` if GitHub CLI is installed; otherwise clones
109
+
- Initializes `.vit/` in the checked-out repo
110
+
- Prints next-step directions
111
+
112
+
Adopt is the fast path to join an existing project.
113
+
80
114
### follow
81
115
82
116
Subscribe to an ATProto handle.
···
173
207
174
208
## Workflow Model
175
209
210
+
Setup (one-time):
211
+
212
+
```bash
213
+
vit init
214
+
vit adopt <beacon>
215
+
```
216
+
176
217
Typical flow:
177
218
178
219
```bash
···
191
232
```
192
233
193
234
Conceptual lifecycle:
235
+
- Init prepares the environment
236
+
- Adopt joins a project via its beacon
194
237
- Beacon anchors the project
195
238
- Caps describe structured changes
196
239
- Vet validates integrity (mandatory before action)