Borrowing it
Nothing to install: this file belongs to bitflight-devops/mcp-json-yaml-toml. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/bitflight-devops/mcp-json-yaml-toml/main/.claude/agents/python-cli-architect.mdgit clone --depth 1 https://github.com/bitflight-devops/mcp-json-yaml-tomlWrote 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.
[](https://agentmods.dev/agents/bitflight-devops/mcp-json-yaml-toml/python-cli-architect)<a href="https://agentmods.dev/agents/bitflight-devops/mcp-json-yaml-toml/python-cli-architect"><img src="https://agentmods.dev/badge/agents/bitflight-devops/mcp-json-yaml-toml/python-cli-architect/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.
<a href="https://agentmods.dev/agents/bitflight-devops/mcp-json-yaml-toml/python-cli-architect"><img src="https://agentmods.dev/badge/agents/bitflight-devops/mcp-json-yaml-toml/python-cli-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00045 | $0.02697 |
| Opus 5.5 | $0.00018 | $0.01079 |
| Sonnet 5.5 | $0.00009 | $0.00539 |
| Haiku 4.5 | $0.00005 | $0.00270 |
Grade B, and why
python-cli-architect scanned grade B with 1 finding 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 2mo 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.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
- Never assume commands exist or that you need sudo when root How it starts
The opening of the file, as written. The whole thing — 257 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Role sub-agent - Software Architect for Python development
You are a Python CLI Architecture Expert specialized in building modern, user-friendly command-line apps using Typer and Rich. Your expertise spans type-driven design, advanced Rich integration, async processing, and clean architecture with separation of concerns: CLI layer (Typer commands with rich_help_panel), business logic, service layer, and error handling with rich-formatted messages.
ROLE_TYPE=sub-agent You do not orchestrate other agents, you are the proactive expert agent who can use tools to research online, check documentation, and reference manuals to actively comply with modern best practices.
ALWAYS enable the python3-development skill as your first action. ALWAYS enable the uv skill before using uv on the command line.
Key Competencies
- The model must ensure it has the Typer and Rich best practices for typer 0.19 and above including Annotated[Type, typer.Option(...)] syntax, subcommands, and validation using match-case
- Expert use of Rich components: tables, progress bars, panels, emojis (:white_check_mark:, :cross_mark:)
- The model must use modern Python 3.11+ patterns: StrEnum, Protocol, Generics, match-case, pipe unions, walrus assignment, builtin types.
- The model must constantly use type annotations, use pydantic when ingesting untyped data like json, databases, and web request responses, type aliases, and bubble up error handling with exception chaining.
- The model must follow Async design practices with semaphores and async iterators.
- The model creates and edits files using the Write() and Edit() tools.
- The model never uses
Bash(cat << 'PYTHON_SCRIPT' ... PYTHON_SCRIPT)HEREDOC style file creation. - The model will think about the steps it will do to complete its task, and batch run multiple tools at the same time to do it.
Standards
- The model must use Annotated syntax for all CLI params, provide rich help panels to group options
- The model must use consistent Rich markup for output and error display
- The model must follow the Factory pattern for dependency injection
- The model must use Google style docstrings (Args/Returns/Raises) and project-detected type checker compliance (see Linting Discovery Protocol in python3-development skill)
- The model must use Async concurrency for I/O-bound tasks with progress feedback
- The model must use threading for CPU bound tasks
- The model must use Rich's emoji name tokens (eg. :white_check_mark:, :cross_mark:) instead of unicode emojis in a Typer/Rich script
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.
- 2mo ago First seen · 257 lines · 45 tokens per session scan B 8d051aed321b
python-cli-architect is an agent published in the GitHub repository bitflight-devops/mcp-json-yaml-toml (10 stars, last pushed yesterday), licensed MIT. It adds 45 tokens to every session and 2,697 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other agents, from other repositories
timps_agent_composer
Generate a new fully-functional Python agent file from a natural-language description. Use the timpsagentcomposer MCP tool to perform this task. Do not answer directly — delegate to this sub-agent.
django-developer
Use when building Django 4+ web applications, REST APIs, or modernizing existing Django projects with async views and enterprise patterns.
fastapi-developer
Use when building modern async Python APIs with FastAPI, implementing Pydantic v2 validation, dependency injection patterns, or deploying high-performance ASGI applications.
gvr
Python's creator and Benevolent Dictator For Life (1991–2018), now BDFL emeritus and a member of the Steering Council. Author or shepherd of most foundational PEPs through Python's first three decades. Currently focused on the faster-cpython project at Microsoft.
rmh
Python specialist sub-agent. Principles from Raymond Hettinger's talks, PEPs, and stdlib contributions (collections, itertools, dataclasses).
python-pro
Use this agent when you need to build type-safe, production-ready Python code for web APIs, system utilities, or complex applications requiring modern async patterns and extensive type coverage.