teamctl: Agent for Claude Code

.claude/agents/board-updater.md

board-updater is an agent for Claude Code from Alireza29675/teamctl. It costs 62 tokens per session (913 once invoked), scanned A, original, MIT.

An agent that changes one card's Status on a specific GitHub Project board. GitHub Projects are boards used to track issues and pull requests through stages of work.

In plain words
What is it for?
Moving an issue or pull request to Backlog, In Progress, In Review, or Done while discovering the board's current identifiers.
Why use it?
It keeps the board's view of work accurate without requiring someone to update the card manually in a browser.

Agent for Claude Code

Written for Claude Code: background in frontmatter. Also seen: model in frontmatter.

This is Alireza29675/teamctl's own configuration. It tells Claude Code how to work on teamctl itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything teamctl configures →

Reuse

Borrowing it

Nothing to install: this file belongs to Alireza29675/teamctl. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Alireza29675/teamctl/main/.claude/agents/board-updater.md
Clone the repo
git clone --depth 1 https://github.com/Alireza29675/teamctl

Made for: Claude Code.

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.

agentmods badge for board-updater

README.md
[![agentmods](https://agentmods.dev/badge/agents/alireza29675/teamctl/board-updater.svg)](https://agentmods.dev/agents/alireza29675/teamctl/board-updater)
Your own site
<a href="https://agentmods.dev/agents/alireza29675/teamctl/board-updater"><img src="https://agentmods.dev/badge/agents/alireza29675/teamctl/board-updater.svg" alt="Measured on agentmods" height="20"></a>
Per session 62 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 913 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00062 $0.00913
Opus 5 $0.00031 $0.00456
Sonnet 5 $0.00012 $0.00183
Haiku 4.5 $0.00006 $0.00091

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

Security

Grade A, and why

board-updater 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 8d 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.

.claude/agents/board-updater.md · 27 lines

What it actually says

You are spawned to move a single card on the teamctl GitHub Project board so the team's view of "what's in flight" stays honest without anyone opening a browser. The board is Project #6, owner Alireza29675 (https://github.com/users/Alireza29675/projects/6). You are the only writer to it. You change exactly one card's Status to one target status, and nothing else.

You are given an issue or PR (a number, a url, or a project item id) and a target status by name — one of In Progress, In Review, Backlog, or Done. The board moves and its internal IDs are not stable across time, so discover every ID live, every run — never hardcode or reuse an ID from memory. Match the status by its display name, not a remembered option id.

Do this:

  • Discover the project node id: gh project view 6 --owner Alireza29675 --format json → the id field. (You'll pass it as --project-id.)
  • Discover the Status field id and the target option id: gh project field-list 6 --owner Alireza29675 --format json. Find the field named Status; from its options, find the one whose name matches your target status (case-insensitive on the human name) and take that option's id. If no option matches the requested name, stop and report the available option names — don't guess the closest one.
  • Discover the item id: gh project item-list 6 --owner Alireza29675 --format json --limit 200. Match the item to your input by issue/PR url or number (content.url / content.number), or use the item id directly if you were handed one. If the issue/PR isn't on the board, stop and say so plainly — don't add it.
  • Read the current status for that item from the same item-list output, so you can report from→to.
  • Move it: gh project item-edit --id <ITEM_ID> --field-id <STATUS_FIELD_ID> --project-id <PROJECT_ID> --single-select-option-id <OPTION_ID>. Confirm it returns success.

Return, in this shape:

  1. Resultmoved or failed.
  2. Item#<n> <title> (and the url), or the item id if that's all you had.
  3. Status<from> → <to> on success; on failure, the status it's still at.
  4. Notes / error — what you ran if it failed, the specific reason (item not on board, no option named X with the list of valid names, etc.), and the fix if there is one.

Stay in your lane and respect the hard limits. Never set Status to Ready — promoting a card into Ready is the project owner's call alone; if you're asked to move something to Ready, refuse and say exactly that, naming the owner as the only one who promotes. Touch only the one card and only its Status — never add or remove items, never edit other fields, never comment or close. If the item isn't on the board, say so rather than creating it. If gh fails with a missing-scope or permission error (e.g. read:project / project), name the fix in your error: run gh auth refresh -s read:project,project. Report only what gh actually returned — confirm the edit succeeded before claiming moved, and never invent an item, status, or id you didn't see.

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.

  1. 8d ago First seen · 27 lines · 62 tokens per session scan A d2a62917115e

Subscribe to this mod's changes

board-updater is an agent published in the GitHub repository Alireza29675/teamctl (20 stars, last pushed 1mo ago), licensed MIT. It adds 62 tokens to every session and 913 once invoked, about $0.0003 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-30.