What is gestao-trilhas?

A Portuguese-language workflow guide for managing long-running work tracks across agent sessions. It describes creating a track, moving between work blocks, closing and archiving it, recording knowledge in a wiki, and checking required files and statuses.

It is for opening, updating, transitioning, closing, archiving, or auditing a long-running work track.

It keeps work that spans multiple sessions organized on disk, with a plan and handoff information that the next session can continue.

gestao-trilhas — Skill for Claude Code and Codex by juliano-ceconi

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add juliano-ceconi/okam --skill gestao-trilhas

Clone the repo

git clone --depth 1 https://github.com/juliano-ceconi/okam

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/juliano-ceconi/okam/gestao-trilhas/github.svg)](https://agentmods.dev/skills/juliano-ceconi/okam/gestao-trilhas)

Your own site

<a href="https://agentmods.dev/skills/juliano-ceconi/okam/gestao-trilhas"><img src="https://agentmods.dev/badge/skills/juliano-ceconi/okam/gestao-trilhas/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/juliano-ceconi/okam/gestao-trilhas"><img src="https://agentmods.dev/badge/skills/juliano-ceconi/okam/gestao-trilhas.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,260 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00073	$0.01260
Opus 5	$0.00036	$0.00630
Sonnet 5	$0.00015	$0.00252
Haiku 4.5	$0.00007	$0.00126

Measured 11d ago against content hash 9bc2de10b020, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

gestao-trilhas scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/gestao-trilhas/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

🛤️ Gestão de Trilhas

Trilha = uma frente de trabalho longa demais para uma única sessão de agente. Ela vive em disco, carrega seu próprio plano e entrega o handoff da próxima sessão. Esta skill define o ciclo de vida dessa pasta.

Diretório padrão: __task-atual/. Se o projeto usar outro nome, mantenha a mesma estrutura interna — o que importa são os invariantes abaixo, não o caminho.

🏛️ Invariantes estruturais

Estado da trilha	Localização	Arquivos obrigatórios	Link no mapa	Status permitidos
Ativa	`__task-atual/<trilha>/`	`_proximo_prompt.md` + `plano.md`	`[Abrir](<trilha>/_proximo_prompt.md)`	`Ativa` (ou `Em Andamento`)
Finalizada	`__task-atual/_finalizadas/<trilha>/`	`fechamento.md` + `plano.md`	`[Abrir](_finalizadas/<trilha>/fechamento.md)`	`Inativa / ConcluídaInativa / AbsorvidaInativa / Represada`

Taxonomia de fechamento:

Inativa / Concluída — escopo do plano 100% finalizado, validado e entregue.
Inativa / Absorvida — escopo incorporado a outra trilha ativa, para evitar conflito de arquivo ou de arquitetura.
Inativa / Represada — congelada por priorização ou dependência externa.

Central de controle: __task-atual/mapa-de-trilhas.md — apenas um índice de status. Nunca serve como arquivo de continuidade da sessão.
Continuidade: _proximo_prompt.md é o único handoff válido de uma trilha ativa.
Sincronização: toda operação de ciclo de vida termina em commit atômico + push.

🚀 Playbooks

1. Abertura (`abrir`)

Criar __task-atual/<trilha>/ (kebab-case).
Criar plano.md: objetivo, contexto, blocos sequenciais (B1..Bn), critérios de pronto e anti-escopo (o que explicitamente fica de fora).
Criar _proximo_prompt.md: cabeçalho de ACK em branco, self-check, contrato da sessão e foco estrito no bloco inicial (B1).

Registrar a linha no mapa:

| <trilha> | **Ativa.** <objetivo e bloco atual> | Ativa | [Abrir](<trilha>/_proximo_prompt.md) |

Auditar os invariantes (seção 4) e sincronizar.

Read the full file on GitHub · 92 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

11d ago First seen · 92 lines · 73 tokens per session scan A 9bc2de10b020

Subscribe to this mod's changes

gestao-trilhas is a skill published in the GitHub repository juliano-ceconi/okam (2 stars, last pushed 25d ago), licensed MIT. It adds 73 tokens to every session and 1,260 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Planning Project management agentes agents governanca ia okf open-source

R-dev

Roxabi/roxabi-plugins · 0 tokens

issue-triage

Roxabi/roxabi-plugins · 0 tokens

task-lifecycle

Manage the task pipeline. All commands use $TASKCTL from the project root.

Aura-Industry/AuraOS · 0 tokens

parallel-feature-development

Coordinate parallel feature development with file ownership strategies, conflict avoidance rules, and integration patterns for multi-agent implementation. Use this skill when decomposing a large feature into independent work streams, when two or more agents need to implement different layers of the same system…

wshobson/agents · 105 tokens

bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/agents · 36 tokens

track-management

Use this skill when creating, managing, or working with Conductor tracks - the logical work units for features, bugs, and refactors. Applies to spec.md, plan.md, and track lifecycle operations.

wshobson/agents · 44 tokens