agentleFS
ozzy-labsozzy-labs/create-agentic-aws/AGENTS.md

create-agentic-aws

AGENTS.md1 starsChanged 5 months agoMITView on GitHub

このファイルは AI エージェント向けの共通 instructions です。 create-agentic-aws: AI エージェント対応の AWS プロジェクトを対話的に生成する CLI ツール。 コード変更後、ユーザーに完了を報告する前に以下を*必ず*通すこと: 言語・コミット・ブランチ・PR のルールは README.md を参照すること。

  • Reads credentials
  • Installs packages

The file

Files
AGENTS.md

AGENTS.md

このファイルは AI エージェント向けの共通 instructions です。

基本方針

  • 日本語で応答する
  • 推奨案とその理由を提示する
  • .env ファイルは読み取り・ステージングしない
  • 破壊的な Git 操作を避ける

プロジェクト概要

create-agentic-aws: AI エージェント対応の AWS プロジェクトを対話的に生成する CLI ツール。

Tech Stack

  • Runtime: Node.js 22+ (ESM)
  • Package manager: pnpm 10
  • Version management: mise (.mise.toml)
  • Build: tsdown (Rolldown ベース)
  • Test: vitest
  • Lint/Format: Biome (TS/JS/JSON), shellcheck + shfmt, markdownlint-cli2 + mdformat, yamlfmt + yamllint, taplo, actionlint
  • Secrets: Gitleaks
  • Git hooks: lefthook

主要コマンド

pnpm install               # 依存関係インストール
pnpm run dev               # ウォッチモードビルド
pnpm run build             # プロダクションビルド
pnpm test                  # テスト実行
pnpm run verify            # 生成出力の検証(コミット前に必須)
pnpm run lint:all          # 全 linter + typecheck + gitleaks
pnpm run typecheck         # TypeScript 型チェック

検証(必須)

コード変更後、ユーザーに完了を報告する前に以下を必ず通すこと:

  1. pnpm run build — ビルド成功
  2. pnpm test — 全テスト通過(verify 含む)
  3. pnpm run typecheck — 型チェック通過

コーディング規約

  • TypeScript: ESM ("type": "module")、strict mode、NodeNext モジュール解決
  • 型のみのインポートには import type を使用(verbatimModuleSyntax 有効)
  • インデント: 2 スペース (TS/JS/JSON/YAML)
  • 改行コード: LF のみ
  • 最大行幅: 100 (Biome)
  • YAML ファイル拡張子: .yaml(ツールが .yml を要求する場合は許容)

規約

言語・コミット・ブランチ・PR のルールは README.md を参照すること。

<!-- begin: @ozzylabs/skills -->

Available Skills

  • commit — 変更をステージし、Conventional Commits でコミットする。プッシュや PR 作成は行わない。
  • commit-conventions — Conventional Commits のメッセージ生成ルール(Type/Scope 判定表、フォーマット)。他スキルから参照される。
  • drive — Issue または指示から実装・PR 作成・セルフレビュー・修正を自動で回し、merge-ready な PR を出す。単一/複数の Issue/PR と明示依存記法に対応。オプションでマージまで実行可能。
  • health — リポジトリ改修中に意図せず残る状態(working tree, stash, branch, worktree, PR, issue, actions など)と skill catalog 整合性を一発で確認し、16 領域のステータス表で俯瞰しつつ各項目に固定語彙の推奨アクションを inline で付与して報告する。--deep 指定時は 要確認 項目を read-only コマンドで追加調査し、機械判定可能な範囲でラベルを格上げする。検査と提示のみで、削除・close 等の実行は行わない。
  • implement — Issue または指示をもとに、ブランチ作成・実装計画・コード変更を行う。Issue 番号またはテキスト指示を受け取る。
  • lint — 全リンターを自動修正付きで実行し、結果を報告する。コード品質チェック、フォーマット、型チェック、セキュリティスキャンを含む。
  • lint-rules — 拡張子別リンター・フォーマッターのコマンド対応表と型チェックルール。他スキルから参照される。
  • phase-issue — Phase-N tracking issue を生成する。cross-session handoff context、決定事項表、PR ごとのタスク、DoD、Phase N+1 outlook を含む構造化された issue body を組み立てて gh issue create で起票する。引数で全項目を渡す非対話モードと、不足分を補う対話モード(Claude Code companion)に対応する。
  • pr — コミット済みの変更をリモートにプッシュし、PR を作成・更新する。
  • review — コード変更や PR を 11 観点(perspectives)でレビューし、JSON 構造化出力 + 人間可読レポートで報告する。quick / deep モードを切替可能。PR 番号またはワーキングツリー差分を入力に取る。
  • ship — lint・コミット・PR 作成を一括実行する。変更に対して lint → コミット → PR 作成を順に実行する統合パイプライン。
  • sync-consumers — skills / commons の更新を sync-targets.yaml に記載された 14 consumer リポへ並列に push し、PR auto-merge まで完結させる。drive の Phase Final 仕様(worktree drift 検出 + cleanup)を踏襲する push 型同期スキル。
  • test — ビルド・テスト・型チェックを実行し、結果を報告する。
  • topics — GitHub topics 候補を制約検証・人気度測定・broad+narrow / 単数複数比較・ozzy-labs 慣行ハードコードで選定し、gh repo edit --add-topic で適用する。スコープは ozzy-labs 内利用のみ。
<!-- end: @ozzylabs/skills -->

Adapter Files

AgentConfiguration
Claude CodeCLAUDE.md, .claude/
Gemini CLI.gemini/settings.json → AGENTS.md
Codex CLIAGENTS.md + .agents/skills/
GitHub Copilot.github/copilot-instructions.md → AGENTS.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.