How simonli357/t3-workflows works
T3 Workflows is a global CLI and agent skill for creating and managing T3 sessions, coordinating workers across linked environments, and maintaining a custom T3 build. The main user flow resolves a project and profile, then plans or runs a spawn/fork against a T3 server; related commands find sessions, assess capacity, move workers, and manage peers. Separate branches review upstream changes and release the custom build. Deployment helpers validate and reconcile activation evidence. The README documents several capabilities whose implementation was not sampled, so their internal links are omitted rather than inferred.
Main entry points: t3w.mjs T3 workflows CLI · fork-session.mjs Spawn and fork · release.py Build and activate · cli.mjs Deployment commands
Components 25
Session workflows
- T3 workflows CLI
bin/t3w.mjs - Project resolution
skills/t3-fork-session/scripts/config.mjs - Spawn and fork
skills/t3-fork-session/scripts/fork-session.mjs - Session history
skills/t3-fork-session/scripts/find-session.mjs
Worker coordination
- Capacity checks
skills/t3-fork-session/scripts/check-capacity.mjs - Host capacity data
skills/t3-fork-session/scripts/capacity-load.mjs - Peer links
skills/t3-fork-session/scripts/peers.mjs - Environment protocol
skills/t3-fork-session/scripts/protocol.mjs - Session moves
skills/t3-fork-session/scripts/move-session.mjs - Worker profiles
skills/t3-fork-session/scripts/worker-profile.mjs - Refresh fork bases
skills/t3-fork-session/scripts/refresh-bases.mjs - Worker statistics
skills/t3-fork-session/scripts/report-stats.mjs - Worker settlement
skills/t3-fork-session/scripts/settle-worker.mjs
Build maintenance
- Build and activate
release/release.py - Migration rehearsal
- Release trial
release/trial.py
Deployment safety
- Deployment commands
deploy/cli.mjs - Native deployment verifier
deploy/native.mjs - Deployment validation
deploy/core.mjs - Failure recovery
deploy/recovery.mjs - Prepared-state review
deploy/prepared-review.mjs
Upstream review
- Upstream change review
bin/check-upstream.mjs
Other components
- CLI user
- T3 server
- Upstream Git remote
Connections 28
- CLI user → T3 workflows CLI: runs commands
- T3 workflows CLI → Spawn and fork: dispatches sessions
bin/t3w.mjs - T3 workflows CLI → Project resolution: resolves projects
bin/t3w.mjs - Spawn and fork → Project resolution: resolves project
skills/t3-fork-session/scripts/fork-session.mjs - Spawn and fork → T3 server: plans and creates
- T3 workflows CLI → Session history: dispatches find
- T3 workflows CLI → Capacity checks: dispatches capacity
- Capacity checks → Host capacity data: reads capacity
skills/t3-fork-session/scripts/check-capacity.mjs - T3 workflows CLI → Peer links: dispatches peer commands
- Spawn and fork → Environment protocol: uses protocol
skills/t3-fork-session/scripts/fork-session.mjs - Spawn and fork → Peer links: uses remote environments
skills/t3-fork-session/scripts/fork-session.mjs - T3 workflows CLI → Session moves: dispatches moves
- T3 workflows CLI → Worker profiles: dispatches profiles
- T3 workflows CLI → Refresh fork bases: dispatches refresh
- T3 workflows CLI → Worker statistics: dispatches reports
- T3 workflows CLI → Worker settlement: dispatches settlement
- CLI user → Build and activate: requests release
- Build and activate → Migration rehearsal: rehearses migrations
- Build and activate → Release trial: runs release trial
release/trial.py - CLI user → Deployment commands: runs deployment
- Deployment commands → Native deployment verifier: invokes verifier
deploy/cli.mjs - Deployment commands → Deployment validation: uses validation
deploy/cli.mjs - Native deployment verifier → Deployment validation: validates deployment
deploy/native.mjs - Native deployment verifier → Failure recovery: checks recovery
deploy/native.mjs - Failure recovery → Deployment validation: uses validation
deploy/recovery.mjs - Failure recovery → Prepared-state review: inspects prepared state
deploy/recovery.mjs - CLI user → Upstream change review: requests review
- Upstream change review → Upstream Git remote: fetches changes