teamcast 0.9.3-a → 0.9.3-b
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/README.md +37 -22
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# TeamCast
|
|
2
2
|
|
|
3
|
-
CLI to design, generate, and validate Claude Code
|
|
3
|
+
CLI to design, generate, and validate multi-target agent teams for Claude Code and Codex from a single manifest.
|
|
4
4
|
|
|
5
|
-
Define your
|
|
5
|
+
Define your agent team in one `teamcast.yaml` file. TeamCast validates the manifest, generates `.claude/` and/or `.codex/` config files, and keeps generated output in sync with the source config.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -23,29 +23,36 @@ npx teamcast <command>
|
|
|
23
23
|
teamcast init
|
|
24
24
|
|
|
25
25
|
# Or skip the wizard and use a preset directly
|
|
26
|
-
teamcast init --preset feature-team
|
|
26
|
+
teamcast init --preset feature-team --target both
|
|
27
27
|
|
|
28
|
-
# Generate
|
|
28
|
+
# Generate files for the targets defined in teamcast.yaml
|
|
29
29
|
teamcast generate
|
|
30
30
|
|
|
31
31
|
# Validate the manifest
|
|
32
32
|
teamcast validate
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
After `generate`, your project will have:
|
|
36
|
-
-
|
|
37
|
-
- `.claude/
|
|
38
|
-
- `.claude/
|
|
39
|
-
- `.claude/settings.
|
|
40
|
-
-
|
|
41
|
-
- `
|
|
35
|
+
After `generate`, your project will have files for the selected target(s):
|
|
36
|
+
- Claude target:
|
|
37
|
+
- `.claude/agents/<name>.md` - one file per agent
|
|
38
|
+
- `.claude/skills/<skill>/SKILL.md` - one stub file per unique skill
|
|
39
|
+
- `.claude/settings.json` - permissions and sandbox config
|
|
40
|
+
- `.claude/settings.local.json` - local Claude settings when enabled
|
|
41
|
+
- `CLAUDE.md` - team documentation for Claude Code
|
|
42
|
+
- `AGENTS.md` - shared agent documentation generated alongside the Claude docs target
|
|
43
|
+
- Codex target:
|
|
44
|
+
- `.codex/config.toml` - workspace-level Codex config
|
|
45
|
+
- `.codex/agents/<name>.toml` - one TOML config per agent
|
|
42
46
|
|
|
43
|
-
|
|
47
|
+
Use `teamcast init --target claude|codex|both` to choose which outputs are generated up front.
|
|
44
48
|
|
|
45
|
-
|
|
49
|
+
## Target Model
|
|
46
50
|
|
|
47
|
-
|
|
48
|
-
|
|
51
|
+
TeamCast now uses a canonical manifest shape with target-specific blocks:
|
|
52
|
+
|
|
53
|
+
- `claude.agents.<name>` - native Claude Code runtime fields and doc outputs
|
|
54
|
+
- `codex.agents.<name>` - native Codex runtime fields and TOML outputs
|
|
55
|
+
- `<target>.agents.<name>.forge` - TeamCast-only metadata such as delegation graph
|
|
49
56
|
|
|
50
57
|
Legacy flat manifests are still accepted and normalized automatically, but new writes use the canonical shape.
|
|
51
58
|
|
|
@@ -54,7 +61,7 @@ Legacy flat manifests are still accepted and normalized automatically, but new w
|
|
|
54
61
|
| Command | Description |
|
|
55
62
|
|---------|-------------|
|
|
56
63
|
| `init` | Initialize `teamcast.yaml` and generate files |
|
|
57
|
-
| `generate` | Generate
|
|
64
|
+
| `generate` | Generate target files from `teamcast.yaml` |
|
|
58
65
|
| `validate` | Validate the team configuration |
|
|
59
66
|
| `validate --format json` | Machine-readable validation output for CI pipelines |
|
|
60
67
|
| `explain` | Print a human-readable view of the team architecture |
|
|
@@ -73,6 +80,7 @@ Useful options:
|
|
|
73
80
|
```bash
|
|
74
81
|
teamcast init --preset <name> # skip wizard and use a preset
|
|
75
82
|
teamcast init --from <path> # initialize from an existing YAML file
|
|
83
|
+
teamcast init --target <name> # generate claude, codex, or both
|
|
76
84
|
teamcast init --yes # non-interactive init, uses defaults
|
|
77
85
|
teamcast generate --dry-run # preview generated files without writing
|
|
78
86
|
teamcast validate --strict # fail on warnings as well as errors
|
|
@@ -109,20 +117,24 @@ Interactive wizard flow:
|
|
|
109
117
|
1. `Project name:`
|
|
110
118
|
- default is auto-detected from the current directory
|
|
111
119
|
- must match lowercase letters, numbers, and hyphens
|
|
112
|
-
2. `
|
|
120
|
+
2. `Which target configs should TeamCast generate?`
|
|
121
|
+
- `Claude`
|
|
122
|
+
- `Codex`
|
|
123
|
+
- `Both`
|
|
124
|
+
3. `How do you want to set up your agent team?`
|
|
113
125
|
- `Use a preset`
|
|
114
126
|
- `Custom team`
|
|
115
127
|
- `Single agent`
|
|
116
|
-
|
|
128
|
+
4. If you choose `Use a preset`:
|
|
117
129
|
- `Select a preset:`
|
|
118
|
-
|
|
130
|
+
5. If you choose `Custom team`:
|
|
119
131
|
- `Select roles for your team:`
|
|
120
132
|
- available roles: `orchestrator`, `planner`, `researcher`, `developer`, `tester`, `reviewer`, `security-auditor`
|
|
121
133
|
- if `orchestrator` is selected with other roles, handoffs are auto-wired to the other selected agents
|
|
122
|
-
|
|
134
|
+
6. `Customize agents before generating?`
|
|
123
135
|
- if yes, each agent gets:
|
|
124
136
|
- `Model for <agent>:`
|
|
125
|
-
|
|
137
|
+
7. Preview:
|
|
126
138
|
- shows the files that will be created
|
|
127
139
|
- asks `Generate these files?`
|
|
128
140
|
|
|
@@ -139,6 +151,7 @@ Non-interactive `init` flows:
|
|
|
139
151
|
- `teamcast init --preset <name>`
|
|
140
152
|
- skips the wizard
|
|
141
153
|
- loads the preset
|
|
154
|
+
- uses the selected `--target` value, or `claude` if omitted
|
|
142
155
|
- uses the detected directory name as `project.name`
|
|
143
156
|
- writes `teamcast.yaml`
|
|
144
157
|
- generates files immediately
|
|
@@ -440,7 +453,9 @@ Use `--yes` to skip confirmation.
|
|
|
440
453
|
|
|
441
454
|
Everything is defined in `teamcast.yaml` at the root of your project.
|
|
442
455
|
|
|
443
|
-
For
|
|
456
|
+
For Claude targets, TeamCast renders `.claude/agents/<name>.md`, `CLAUDE.md`, and `AGENTS.md` from `claude.agents.<name>`.
|
|
457
|
+
|
|
458
|
+
For Codex targets, TeamCast renders `.codex/agents/<name>.toml` plus `.codex/config.toml` from `codex.agents.<name>`.
|
|
444
459
|
|
|
445
460
|
Native Claude Code fields are rendered into frontmatter:
|
|
446
461
|
|