arckit-framework

arckit-framework is an agent for Claude Code from tractorjuice/arckit-gemini. It costs 223 tokens per session (4,051 once invoked), scanned B, original, MIT.

An architecture agent that turns a project's existing documents and other files into an organised framework with phases, an overview and an executive guide.

In plain words
What is it for?
Use it to organise architecture documents, group existing information into a coherent framework and prepare high-level guidance for decision-makers.
Why use it?
It makes scattered project material easier to understand without asking the agent to invent new requirements or designs.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: mentions Gemini CLI.

Good fit Use it to organise architecture documents, group existing information into a coherent framework and prepare high-level guidance for decision-makers.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/tractorjuice/arckit-gemini/arckit-framework
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.

Clone the repo
git clone --depth 1 https://github.com/tractorjuice/arckit-gemini

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 arckit-framework

README.md
[![agentmods](https://agentmods.dev/badge/agents/tractorjuice/arckit-gemini/arckit-framework/github.svg)](https://agentmods.dev/agents/tractorjuice/arckit-gemini/arckit-framework)
Your own site
<a href="https://agentmods.dev/agents/tractorjuice/arckit-gemini/arckit-framework"><img src="https://agentmods.dev/badge/agents/tractorjuice/arckit-gemini/arckit-framework/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.

agentmods 80×15 button for arckit-framework

Your own site · 80×15
<a href="https://agentmods.dev/agents/tractorjuice/arckit-gemini/arckit-framework"><img src="https://agentmods.dev/badge/agents/tractorjuice/arckit-gemini/arckit-framework.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 223 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,051 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. 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.00223 $0.04051
Opus 5.5 $0.00089 $0.01620
Sonnet 5.5 $0.00045 $0.00810
Haiku 4.5 $0.00022 $0.00405

Measured 2d ago against content hash 7e691e519530, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

arckit-framework 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 2d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- To read templates/files: use a shell command, e.g. `cat ~/.gemini/extensions/arckit/templates/foo-template.md`
agents/arckit-framework.md · 265 lines

How it starts

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

IMPORTANT — Gemini Extension File Access: This command runs as a Gemini CLI extension. The extension directory (~/.gemini/extensions/arckit/) is outside the workspace sandbox, so you CANNOT use the read_file tool to access it. Instead:

  • To read templates/files: use a shell command, e.g. cat ~/.gemini/extensions/arckit/templates/foo-template.md
  • To list files: use ls ~/.gemini/extensions/arckit/templates/
  • To run scripts: use python3 ~/.gemini/extensions/arckit/scripts/python/create-project.py --json
  • To check file existence: use test -f ~/.gemini/extensions/arckit/templates/foo-template.md && echo exists All extension file access MUST go through shell commands.

You are an enterprise architecture framework specialist. You transform scattered architecture artifacts into structured, phased frameworks. Your role is purely one of synthesis — you do not generate new requirements, analysis, or design. You organise, summarise, and present what already exists.

Guardrails

  • Existing artefacts under projects/ are the only input. This agent has no web or MCP access. Never invent requirements, decisions, or evidence not present in the source artefacts; if a phase has no source material, mark it [UNSOURCED] rather than synthesising plausible content.
  • Synthesis only — no new analysis. Quote, link, and organise existing artefacts; do not draft new requirements, ADRs, or designs in the framework body.
  • Recommend, don't decide. This agent proposes framework structure and groupings; the architecture lead approves the framework before publication. Output remains DRAFT until accountable-officer sign-off.

What you produce

Given a project's existing artefacts under projects/{P}-{NAME}/, you deliver:

  1. Phased framework structure — artefacts grouped into logical phases that match the system being governed (Ashby's Law).
  2. Framework overview — projects/{P}-{NAME}/framework/ARC-{P}-FWRK-vN.N.md with the phased index and Document Map.
  3. Executive guide — projects/{P}-{NAME}/framework/{Project-Name}-Executive-Guide.md summarising the framework for senior stakeholders. Deliberately not an ARC-* artefact: it is a narrative guide, not a governed document (see the write step below).
  4. Document Map and Traceability — every artefact placed in the framework with cross-references intact.
  5. Coverage and gap commentary — phases where the existing artefacts are thin, surfacing what's missing without inventing replacements.

Read the full file on GitHub · 265 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.

  1. 2d ago Changed 7e691e519530
  2. 2mo ago First seen · 265 lines · 223 tokens per session scan B 3d17cb1c2e7e

Subscribe to this mod's changes

arckit-framework is an agent published in the GitHub repository tractorjuice/arckit-gemini (3 stars, last pushed 4d ago), licensed MIT. It adds 223 tokens to every session and 4,051 once invoked, about $0.0009 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

arckit-datascout

Use this agent when the user needs to discover external data sources — APIs, datasets, open data portals, and commercial data providers — to fulfil project requirements. This agent performs extensive web research to find real, current data sources. Examples: Context: User has a project with requirements and wants to…

tractorjuice/arc-kit · 398 tokens

arckit-gov-landscape

Use this agent when the user wants to understand what UK government has built in a domain — mapping organisations, technology patterns, standards, and maturity levels. Examples: Context: User wants to understand the government landscape for a domain user: "/arckit:gov-landscape Map the government landscape for health…

tractorjuice/arc-kit · 320 tokens

arckit-aws-research

Use this agent when the user needs AWS-specific technology research using the AWS Knowledge MCP server to match project requirements to AWS services, architecture patterns, Well-Architected guidance, and Security Hub controls. Examples: Context: User has a project with requirements and wants AWS service…

tractorjuice/arc-kit · 387 tokens

arckit-competitors-writer

Writer subagent invoked by the /arckit:competitors orchestrator command. Renders a validated, orchestrator-prepared payload into a CMPT Competitor Landscape artefact under projects/{P}-{NAME}/research/, and spawns/enriches per-vendor Government Award History profiles. Has no web/MCP/Agent tools. Not user-invocable …

tractorjuice/arc-kit · 101 tokens

arckit-framework

Use this agent when the user wants to transform existing project artifacts into a structured framework with phased organization, an overview document, and an executive guide. This agent reads all project artifacts and synthesises them into a coherent framework structure. Examples: Context: User has multiple artifacts…

tractorjuice/arc-kit · 223 tokens

arckit-gcp-research

Use this agent when the user needs Google Cloud-specific technology research using the Google Developer Knowledge MCP server to match project requirements to Google Cloud services, architecture patterns, Architecture Framework guidance, and Security Command Center controls. Examples: Context: User has a project with…

tractorjuice/arc-kit · 393 tokens