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.
Files changed (2) hide show
  1. package/README.md +37 -22
  2. 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 subagents from a single manifest.
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 subagents in one `teamcast.yaml` file. TeamCast generates Claude Code config files, validates the configuration, and keeps generated output in sync with the manifest.
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 Claude Code config files from teamcast.yaml
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
- - `.claude/agents/<name>.md` - one file per agent
37
- - `.claude/skills/<skill>/SKILL.md` - one stub file per unique skill
38
- - `.claude/settings.json` - permissions and sandbox config
39
- - `.claude/settings.local.json` - local Claude settings when enabled
40
- - `CLAUDE.md` - team documentation for Claude Code
41
- - `AGENTS.md` - universal AI agent documentation
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
- ## Native Claude Code Model
47
+ Use `teamcast init --target claude|codex|both` to choose which outputs are generated up front.
44
48
 
45
- TeamCast now uses a canonical agent shape that separates:
49
+ ## Target Model
46
50
 
47
- - `agents.<name>.claude` - native Claude Code subagent runtime fields
48
- - `agents.<name>.forge` - TeamCast-only metadata such as delegation graph
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 Claude Code files from `teamcast.yaml` |
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. `How do you want to set up your agent team?`
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
- 3. If you choose `Use a preset`:
128
+ 4. If you choose `Use a preset`:
117
129
  - `Select a preset:`
118
- 4. If you choose `Custom team`:
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
- 5. `Customize agents before generating?`
134
+ 6. `Customize agents before generating?`
123
135
  - if yes, each agent gets:
124
136
  - `Model for <agent>:`
125
- 6. Preview:
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 each agent, TeamCast renders `.claude/agents/<name>.md` from `agents.<name>.claude`.
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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "teamcast",
3
- "version": "0.9.3-a",
3
+ "version": "0.9.3-b",
4
4
  "description": "YAML-driven CLI to design, validate, and generate multi-target agent teams for Claude Code and Codex",
5
5
  "type": "module",
6
6
  "bin": {