control-plane
Directs development and interaction with the Control-Plane subsystem, including tasks, runs, and leases.
Install
mkdir -p .claude/skills/control-plane && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16468" && unzip -o skill.zip -d .claude/skills/control-plane && rm skill.zipInstalls to .claude/skills/control-plane
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Control-Plane subsystem in TTA.dev: get_task, get_run, put_run and related code. 88 symbols | 15 files | Cohesion: 81%Key capabilities
- →Work on control-plane related functionality in TTA.dev
- →Modify `get_task` and `get_run` functions
- →Navigate `ttadev/control_plane/store.py` and `ttadev/control_plane/workflow_service.py`
- →Interact with `put_run` and `list_leases` functions
- →Claim tasks and manage run leases
How it works
This skill provides an overview of the control-plane subsystem, including key files, entry points, and symbols. It guides the user to relevant code sections for modification or exploration.
Inputs & outputs
When to use control-plane
- →Debug workflow service logic
- →Interact with task retrieval functions
- →Manage run-service heartbeats
About this skill
Control_plane
88 symbols | 15 files | Cohesion: 81%
When to Use
- Working on
control-plane-related functionality in TTA.dev - Modifying
get_task,get_run - Navigating
ttadev/control_plane/store.py,ttadev/control_plane/workflow_service.py
Key Files
| File | Symbols |
|---|---|
ttadev/control_plane/store.py | _read_map, _write_map, _lock_for, get_task, get_run (+10) |
ttadev/control_plane/workflow_service.py | _emit_control_plane_span, _now_iso, _make_workflow_gate_id, _get_workflow_step, _build_workflow_gate_decision_record (+6) |
ttadev/control_plane/task_service.py | _now, _now_iso, _current_agent_id, _find_gate, _ensure_gate_decider_allowed (+6) |
ttadev/control_plane/lease_service.py | _now, _now_iso, _validate_lock_owner, _acquire_lock, _expire_lease (+6) |
ttadev/control_plane/run_service.py | _now, _now_iso, get_run, get_lease_for_run, list_active_ownership (+5) |
ttadev/control_plane/models.py | to_dict, to_dict, from_dict, to_dict, from_dict (+4) |
ttadev/control_plane/service.py | list_runs, get_run, get_lease_for_run, heartbeat_run, acquire_file_lock (+2) |
tests/unit/test_l0_store.py | _now, test_task_roundtrip, test_run_roundtrip, test_lease_roundtrip_and_delete |
ttadev/cli/control.py | _handle_run_command, _handle_lock_command |
tests/unit/test_control_plane_trace_attribution.py | test_claim_task_stamps_trace_id_on_run, test_workflow_step_round_trips_trace_fields |
Entry Points
Start here when exploring this area:
get_task(Function) —ttadev/control_plane/store.py:51get_run(Function) —ttadev/control_plane/store.py:66put_run(Function) —ttadev/control_plane/store.py:71list_leases(Function) —ttadev/control_plane/store.py:77get_lease_for_task(Function) —ttadev/control_plane/store.py:81
Key Symbols
| Symbol | Type | File | Line |
|---|---|---|---|
get_task | Function | ttadev/control_plane/store.py | 51 |
get_run | Function | ttadev/control_plane/store.py | 66 |
put_run | Function | ttadev/control_plane/store.py | 71 |
list_leases | Function | ttadev/control_plane/store.py | 77 |
get_lease_for_task | Function | ttadev/control_plane/store.py | 81 |
put_lease | Function | ttadev/control_plane/store.py | 92 |
delete_lease | Function | ttadev/control_plane/store.py | 98 |
put_lock | Function | ttadev/control_plane/store.py | 123 |
delete_lock | Function | ttadev/control_plane/store.py | 129 |
to_dict | Function | ttadev/control_plane/models.py | 481 |
to_dict | Function | ttadev/control_plane/models.py | 528 |
from_dict | Function | ttadev/control_plane/models.py | 539 |
to_dict | Function | ttadev/control_plane/models.py | 563 |
test_task_roundtrip | Function | tests/unit/test_l0_store.py | 12 |
test_run_roundtrip | Function | tests/unit/test_l0_store.py | 31 |
test_lease_roundtrip_and_delete | Function | tests/unit/test_l0_store.py | 50 |
get_run | Function | ttadev/control_plane/run_service.py | 160 |
get_lease_for_run | Function | ttadev/control_plane/run_service.py | 167 |
list_active_ownership | Function | ttadev/control_plane/run_service.py | 171 |
claim_task | Function | ttadev/control_plane/run_service.py | 213 |
Execution Flows
| Flow | Type | Steps |
|---|---|---|
Main → Get_integration | cross_community | 5 |
Main → Get_integration | cross_community | 5 |
Main → Get_integration | cross_community | 4 |
Acquire_workspace_lock → Release_locks_for_run | intra_community | 4 |
Acquire_file_lock → Release_locks_for_run | intra_community | 4 |
Finalize_tracked_workflow → _now | intra_community | 4 |
Decide_gate → _get_active_session | intra_community | 3 |
Decide_gate → _gate_role_matches | intra_community | 3 |
Control_claim_task → To_dict | cross_community | 3 |
Control_get_run → To_dict | cross_community | 3 |
Connected Areas
| Area | Connections |
|---|---|
| Unit | 17 calls |
| Cli | 2 calls |
How to Explore
gitnexus_context({name: "get_task"})— see callers and calleesgitnexus_query({query: "control_plane"})— find related execution flows- Read key files listed above for implementation details
When not to use it
- →When the task is not related to TTA.dev control-plane functionality
- →When the task does not involve `get_task`, `get_run`, or `put_run`
- →When the task does not require navigating specific control-plane files
Limitations
- →The skill's scope is limited to the TTA.dev control-plane subsystem.
- →The skill focuses on specific functions like `get_task`, `get_run`, and `put_run`.
- →The skill provides navigation and context rather than direct code execution.
How it compares
This skill acts as a specialized guide for the TTA.dev control-plane, providing direct access to relevant files and functions, unlike a general code search.
Compared to similar skills
control-plane side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| control-plane (this skill) | 0 | 3mo | No flags | Intermediate |
| cloudflare-manager | 25 | 10mo | Review | Intermediate |
| distributed-tracing | 5 | 2mo | No flags | Intermediate |
| service-mesh-observability | 5 | 2mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by theinterneti
View all by theinterneti →You might also like
cloudflare-manager
qdhenry
Comprehensive Cloudflare account management for deploying Workers, KV Storage, R2, Pages, DNS, and Routes. Use when deploying cloudflare services, managing worker containers, configuring KV/R2 storage, or setting up DNS/routing. Requires CLOUDFLARE_API_KEY in .env and Bun runtime with dependencies installed.
distributed-tracing
wshobson
Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks. Use when debugging microservices, analyzing request flows, or implementing observability for distributed systems.
service-mesh-observability
wshobson
Implement comprehensive observability for service meshes including distributed tracing, metrics, and visualization. Use when setting up mesh monitoring, debugging latency issues, or implementing SLOs for service communication.
terminal-context
aelaguiz
Complete Kitty terminal awareness + control for coding agents: list panes/tabs, read scrollback, map ports→processes, parse per-pane git/last-command metadata (from shell hooks), and send commands/focus panes. Use when user mentions "another terminal", "is the server running", "what failed", or you need to run/inspect commands across panes.
storage-networking
pluginagentmarketplace
Master Kubernetes storage management and networking architecture. Learn persistent storage, network policies, service discovery, and ingress routing.
aws-solution-architect
alirezarezvani
Design AWS architectures for startups using serverless patterns and IaC templates. Use when asked to design serverless architecture, create CloudFormation templates, optimize AWS costs, set up CI/CD pipelines, or migrate to AWS. Covers Lambda, API Gateway, DynamoDB, ECS, Aurora, and cost optimization.