Skip to content
cccskills
FreePublished on GitHub

using-the-harness

Session-start orientation for this team harness. Load first, before any work. Explains the operating contract, when each skill triggers, and how installed companion plugins supply agent-craft capabilities while this harness supplies the team contract. Trigger at the start of every session and whenever unsure which skill applies.

The English summary is being prepared. Showing the original description.

Works withGoogle Cloud
See how to install

Files included (2)

  • SKILL.md7.4 KB
  • references/antigravity-tools.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Using the Harness

This is a team operating harness: one shared contract for humans and AI agents working in the same repository — same rules, same risk tiers, same evidence, same definition of done. It exists to make a mixed human–AI team coherent, not to make one agent faster.

A skill supplies a repeatable procedure. It never supplies permission or accountability.

First actions, every session

  1. Ground in the contract. If this project has adopted the operating model, read its project profile before anything else (docs/operating-model/PROJECT-OPERATING-PROFILE.md), then the manual it binds. Profile facts beat inference.
  2. Classify risk before acting. Map the requested work to R0–R3. Round ambiguity upward. Confirm authority at that tier before any consequential, destructive, external, or credential-touching action.
  3. Route before doing. Check the routing table below. If a skill applies to the work, use it. If you are unsure which applies, use delivery-orchestrator.

The shared plugin is provider-neutral. Host adapters implement invocation; the project profile selects authorised reviewers, subscriptions and budgets. Independent Council review is a capability, not a fixed roster. See the review contract.

Installation and project adoption

A user-level installation makes the skills available across that user’s projects; a project installation shares a selected baseline with collaborators. Neither creates project authority. Use the host’s selected skill location, including bundled references and scripts, without assuming a copied .agents/skills/ directory.

For a new adoption, route to operating-model-bootstrap from the consumer project. Ground its project-owned vision, workflow and profile: ticket system, owners, model selection, executable checks, review, release and observation. Existing records and explicit operator authority take precedence. Load detailed skills when needed; an unadopted project needs orientation and an adoption path, not the full delivery process.

Core invariants — not negotiable

  • Classify risk before confirming authority. Approval is scoped to actual risk.
  • Infer intent; never infer permission. Useful intent is not a grant of authority.
  • Receipts, not polish. Produce an artefact or a pass/fail verdict, not a narrative.
  • Review binds to the exact candidate. Any change after review invalidates it.
  • seed is not active. A seed profile supports design and R0/R1 work only.
  • Never invent a project fact. Unknowns get an owner and a resolving trigger.
  • Insufficient evidence is a stop, not a prompt to improvise. Tag the roster role that owns the decision; silence never converts to permission.

Skill routing

Work in front of youSkill
New repo, or operating model install/repairoperating-model-bootstrap
Multi-track epic, or "which skill applies?"delivery-orchestrator
An agreed goal to drive to a working, merged outcome while the operator is awayget-it-done
The machine is slow, tests or browser skills left processes behindsystem-performance-guardrail
Is everything live, any errors this week, the weekly SRE checkup of a GCP projectcloud-checkup
Is the page fast enough, Core Web Vitals, why is this route slowfrontend-performance-audit
Vision, requirements, user journeys and product acceptanceproduct-owner
Material strategic, cost/risk or operating ownership decisioncxo-oversight
Acceptance coverage and executable user-path checkstest-strategy
Significant technical decision or ADRthe-architect
New feature, epic, or change — plan before codespec-first-delivery
High-stakes decision, or before claiming doneadversarial-gate
Agent output feeding a decision, store, or another agentdomain-validator
Any PR or agent-generated code before commitpr-reviewer
Anything about to ship to a real environmentrelease-readiness
CI triggers, Actions billing, issues, labels, branch protection, or release-tag workflowgithub-manager
Release process governance: SemVer, ADR, changelog, release authorityrelease-manager
Enterprise policy, compliance, governance, or approved-vendor alignmentgovernance-guardrail
Status, standup, or situation reportsitrep
Plugin-directory, marketplace, or curated-list submissionplugin-submission
LLM/cloud cost estimate or architecture with LLM callscost-guardrail
Google ADK multi-agent designadk-expert
Any cloud-vendor workload (GCP, AWS, Azure, Alibaba Cloud)cloud-expert (the-architect routes)
Adding or reviewing an MCP servermcp-server-scaffold

Companion plugins

Agent-craft capabilities may be provided by installed companion plugins instead of these skills — see INTEGRATIONS.md for the evaluated map (simplicity discipline, TDD methodology, frontend design review, and similar craft lanes).

  • Route craft work to an installed companion when the project profile names one as the provider. Do not re-implement a capability an installed companion already provides.
  • Companions supply capability, never authority. This harness's risk tiers, evidence, and review gates still apply to their output.
  • No companion installed? The baseline skills above are the fallback. Record the equivalent and its owner in the project profile; do not silently skip the capability.

Harness tool mapping

Skills name actions, not tools. The per-harness translation lives outside the canonical skill bodies:

  • Antigravity (Gemini) — read references/antigravity-tools.md (in this skill's directory) before acting; it maps subagent dispatch, task tracking, and file/search actions to Antigravity's native tools.
  • Kimi Code — the plugin manifest's skillInstructions carry the mapping.
  • Claude Code / Codex — the skills' action vocabulary resolves to the native tools of the same names.

Anti-rationalization table

Excuse the agent makesCounter
"The skills are just docs — I can skip them"The skills are the harness. Skipping them is running without the contract.
"This task is too small for a skill"Gates are proportional to risk — R0/R1 is cheap. Skipped small gates are where big failures rehearse.
"The companion plugin handles quality"Companions own craft. Authority, evidence, and completion semantics stay here.
"I'll edit the skill body to fit my tools"Porting adds a thin adapter or tool mapping. Canonical skill bodies never change per harness.
"I remember the contract from earlier"Sessions compact and clear. Re-ground in the tracked profile; memory is not the contract.
"The user seems in a hurry"Speed is easy. Safe speed is engineered. Hurry raises risk tier, it does not lower it.

When unsure

Route through delivery-orchestrator. Record every unresolved fact with an owner and the trigger that resolves it. Stop before any R2/R3 mutation or external action that lacks explicit authority and runnable controls.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Google ADK (Agent Development Kit) orchestration patterns — boundaries, agent composition, and tool seams. Trigger when designing or reviewing multi-agent systems built on ADK. Authoritative source: adk.dev.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

JP's signature red-team pass — "how would I break this?" Argue against your own approach before proceeding. Trigger on any high-stakes decision, architecture choice, or before marking work complete.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Read-only SRE checkup of any GCP project: deterministic probes of the edge, Cloud Run services, 7-day error logs, Cloud Scheduler, alert policies and uptime checks, Secret Manager and IAM, the data stores and the machine's own scheduled jobs, audited into one fixed status table (LIVE / WARNING / RED / INCONCLUSIVE) with evidence, findings by severity, what could not be checked, and a single OVERALL line delivered as one notification. Parametrised by a per-project manifest, so the same routine runs on every project. Use when the operator says "cloud checkup", "SRE check", "is everything live", "what's healthy / warning / red", "any errors this week", "audit the infra", "weekly checkup", "set up the weekly checkup", before a deploy or demo, or after an incident. Cloud Run first; App Engine and GKE differ only in the serving probes.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Cloud guardrails for any vendor workload — Google Cloud (GCP, Vertex AI, GKE), AWS (IAM, EKS, Bedrock), Azure (Entra ID, Policy, AKS), Alibaba Cloud (RAM, mainland/international residency). Enforces identity least-privilege, mechanical policy, data boundaries, residency, cost caps, network egress and observability, with official-source validation before any claim. Trigger on any cloud infrastructure design, review, Terraform plan, or LLM/agent deployment; the-architect routes here.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

LLM and cloud cost awareness — model tiering, token budgets, right-sizing, and when a cheaper model suffices. Trigger before finalising any architecture that calls LLMs, before scaling a workload, or when a cost estimate is needed.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Challenge vision alignment, value, cost, risk and operating ownership at material scope or release decisions.

The English summary is being prepared. Showing the original description.

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

See all skills by jpantsjoha

Report a problem with this skill