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
In this repository3 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- setupSkill
The file
Files
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 型チェック検証(必須)
コード変更後、ユーザーに完了を報告する前に以下を必ず通すこと:
pnpm run build— ビルド成功pnpm test— 全テスト通過(verify 含む)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
| Agent | Configuration |
| Claude Code | CLAUDE.md, .claude/ |
| Gemini CLI | .gemini/settings.json → AGENTS.md |
| Codex CLI | AGENTS.md + .agents/skills/ |
| GitHub Copilot | .github/copilot-instructions.md → AGENTS.md |
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
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.

