Swift-Selena: Agent for Claude Code

.claude/agents/code-header-generator.md

code-header-generator is an agent for Claude Code from BlueEventHorizon/Swift-Selena. It costs 20 tokens per session (693 once invoked), scanned A, original, MIT.

An agent that reads Swift files and adds structured, searchable header comments while preserving the code and existing comments.

In plain words
What is it for?
Use it to create or update headers for individual Swift files while keeping DocC comments, implementation comments, and copyright headers intact.
Why use it?
It documents what a file contains without changing its implementation, and skips files that are excluded or already marked as formatted.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter.

This is BlueEventHorizon/Swift-Selena's own configuration. It tells Claude Code how to work on Swift-Selena 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 Swift-Selena configures →

Reuse

Borrowing it

Nothing to install: this file belongs to BlueEventHorizon/Swift-Selena. 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/BlueEventHorizon/Swift-Selena/main/.claude/agents/code-header-generator.md
Clone the repo
git clone --depth 1 https://github.com/BlueEventHorizon/Swift-Selena

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 code-header-generator

README.md
[![agentmods](https://agentmods.dev/badge/agents/blueeventhorizon/swift-selena/code-header-generator/github.svg)](https://agentmods.dev/agents/blueeventhorizon/swift-selena/code-header-generator)
Your own site
<a href="https://agentmods.dev/agents/blueeventhorizon/swift-selena/code-header-generator"><img src="https://agentmods.dev/badge/agents/blueeventhorizon/swift-selena/code-header-generator/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 code-header-generator

Your own site · 80×15
<a href="https://agentmods.dev/agents/blueeventhorizon/swift-selena/code-header-generator"><img src="https://agentmods.dev/badge/agents/blueeventhorizon/swift-selena/code-header-generator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 20 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 693 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.00020 $0.00693
Opus 5.5 $0.00008 $0.00277
Sonnet 5.5 $0.00004 $0.00139
Haiku 4.5 $0.00002 $0.00069

Measured 1mo ago against content hash e36467f90549, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

code-header-generator 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 1mo 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/code-header-generator.md · 62 lines

What it actually says

概要

Swiftファイルのコード内容を理解し、AI検索可能なコードヘッダーコメントを生成します。

必須参照文書 [MANDATORY]

NEVER skip. 下記を全て読み込み、深く理解すること

  • docs/format/code_header_format.md - フォーマット仕様

実行フロー

Step 1: 準備

  1. promptからファイルパスとモード(skip/update)を取得

    • モード は指定がない場合は skipモードとする
    • skipモードでは、[Code Header Format] マーカーの有無を判定して動作する
      • [Code Header Format] マーカーがある → 「既にフォーマット済みのためスキップしました」と報告して終了
      • [Code Header Format] マーカーがない → Step 4以降の生成処理を実行(マーカーがなければ必ず生成する)
    • updateモード
      • マーカーの有無に関わらず → Step 4以降の生成処理を実行(既存を上書き)
  2. Read()で対象ファイル全体を読み込む

Step 2: コード理解

  1. コードを理解する(実装内容、ロジック、構造)
  2. Testファイルがあれば読んで使用例・意図を理解
  3. 既存コメントがあれば参考にする(鵜呑みにしない)

Step 3: ヘッダー生成

  1. code_header_format.mdに従ってヘッダー生成
    • 必ず [Code Header Format] マーカーを含める
    • 既存の関数・型のDocCコメント(///)は保持
    • 既存の実装コメント(//)も保持

Step 4: ファイル更新

  1. Edit()でファイル更新(Copyrightヘッダーは変更しない)
  2. 結果を報告:
    • 「新規生成しました」(マーカーがなかった場合)
    • 「更新しました」(マーカーがあった場合)

除外対象

  • ファイル名に Test, Tests を含む
  • ファイル名が Mock で始まる
  • Preview Content/ ディレクトリ配下

注意事項

  • 1ファイルずつ処理(並列処理しない)
  • 追加するのはファイルヘッダーのみ
  • 既存の関数・型のDocCコメント(///)は絶対に消さない
  • 既存の実装コメント(//)も保持する
  • コード本体は変更しない
  • 理解できない場合は推測せず、コードを再読
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. 1mo ago First seen · 62 lines · 20 tokens per session scan A e36467f90549

Subscribe to this mod's changes

code-header-generator is an agent published in the GitHub repository BlueEventHorizon/Swift-Selena (5 stars, last pushed 3mo ago), licensed MIT. It adds 20 tokens to every session and 693 once invoked, about $0.0001 per session on Opus 5.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.

Related

Other agents, from other repositories

swift-build-resolver

Swift/Xcode build, compilation, and dependency error resolution specialist. Fixes swift build errors, Xcode build failures, SPM dependency issues, and code signing problems with minimal changes. Use when Swift builds fail.

affaan-m/ECC · 48 tokens

Kotlin MCP Server Development Expert

Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK.

github/awesome-copilot · 26 tokens

elixir-way-architect

Synthesizes rewrite analysis and the ADR-000 compatibility bar into an idiomatic Elixir architecture, a complete mechanism ledger, ADRs and divergences. Use when /rewrite:architect has analysis and an accepted bar.

oliver-kriska/claude-elixir-phoenix · 50 tokens

swiftui-architect

Specialist in modern iOS app architecture with SwiftUI (iOS 26 / Swift 6.2) — the Observation framework (@Observable), MV vs MVVM vs TCA, NavigationStack & deep linking, SwiftData persistence, structured concurrency at the UI boundary, dependency injection & SwiftPM modularization, UIKit interop, and Swift Testing.…

SteveGJones/ai-first-sdlc-practices · 97 tokens

mb-android

Android specialist for memory-bank /mb work stages. Jetpack Compose, Kotlin coroutines, Hilt/DI, Room, Material3. Falls back to mb-developer when stage is generic.

fockus/skill-memory-bank · 43 tokens

mb-ios

You are MB iOS, dispatched when the stage involves Apple-platform code: SwiftUI / UIKit views, view-models, navigation, persistence, networking, Apple-platform integrations (Sign in with Apple, Push, Widgets, App Intents, etc.).

fockus/skill-memory-bank · 39 tokens