付録
付録D: 外部参照一覧
- k16shikano: japanese-tech-writing/SKILL:日本語技術文書の文章規範。段落、論証、用語導入、冗長なLLM口調の抑制を編集方針に採用する。
- Software Engineering at Google:ソフトウェアを時間、変更、規模、チーム、レビュー、テスト、文書として扱う基礎参照。
- Manifesto for Agile Software Development:価値、動くソフトウェア、顧客協働、変化への応答を説明する導入参照。
- Principles behind the Agile Manifesto:早く価値あるソフトウェアを届けること、動くソフトウェア、単純さ、継続的なふりかえりの参照。
- Pro Git:Gitの公式に近い体系的な入門書。履歴、ブランチ、リモート、GitHub連携の補助参照。
- GitHub Docs: Collaborating with pull requests:Pull Request、レビュー、ステータスチェック、マージの公式参照。
- GitHub Docs: About issues:ideas、tasks、bugsをissueとして記録し、sub-issues、dependencies、labelsなどで作業を小さく追跡する公式参照。
- GitHub Docs: About Projects:IssuesやPull Requestsと連動するtable、board、roadmapで作業を計画し追跡する公式参照。
- Google Engineering Practices: Code Review:小さな変更、レビューの姿勢、変更説明を扱う参照。
- MDN: Overview of HTTP:HTTPの要求、応答、クライアント、サーバーを説明する参照。
- MDN: Using HTTP cookies:Cookie、セッション、状態管理の補助参照。
- MDN: Fetch API:フロントエンドからAPIを呼び出す基本参照。
- Martin Fowler: Ubiquitous Language:ドメインの言葉を開発者と利用者の共通語にする考え方。
- Martin Fowler: Bounded Context:用語とモデルの境界を明示する考え方。
- PostgreSQL Documentation: Constraints:NOT NULL、UNIQUE、PRIMARY KEY、FOREIGN KEY、CHECKの具体参照。
- OpenAPI Specification:API契約を機械にも人にも読める形で表す参照。
- W3C WAI: WCAG 2 Overview:WCAGの位置づけと支援資料の入口。2026年6月時点でWCAG 2.2利用が推奨されている。
- W3C Recommendation: WCAG 2.2:知覚可能、操作可能、理解可能、堅牢の原則と成功基準の一次参照。
- Martin Fowler: The Practical Test Pyramid:テストを速度、範囲、信頼性の組み合わせとして考える参照。
- Martin Fowler: Refactoring:既存コードの設計を、ふるまいを保つ小さな変換の積み重ねで改善する考え方の参照。
- OWASP Top Ten:Webアプリケーションセキュリティの共通リスク。2026年6月時点ではTop Ten 2025が現行リリース。
- OWASP Application Security Verification Standard:アプリケーションセキュリティの確認項目を体系化する参照。2026年6月時点ではASVS 5.0.0がlatest stable。
- NIST SP 800-218: Secure Software Development Framework:セキュアなソフトウェア開発の高水準プラクティス。2026年6月時点ではfinalはVersion 1.1。
- Docker Docs: What is Docker?:イメージ、コンテナ、Dockerfile、Composeの入口参照。
- The Twelve-Factor App:設定、依存関係、ログ、環境差分などSaaSアプリの運用原則。
- AWS Well-Architected Framework:クラウド構成を安全性、信頼性、効率、コスト、持続可能性でレビューする参照。
- AWS App Runner: Service based on a source image:ECRなどのimage repositoryからApp Runner serviceを作るときの公式参照。
- AWS App Runner: Managing environment variables:App Runnerで環境変数、Secrets Manager、Parameter Store参照を扱う公式参照。
- GitHub Docs: Configuring OpenID Connect in Amazon Web Services:GitHub ActionsからAWSへOIDCで接続し、長期credentialを置かない方針の公式参照。
- Martin Fowler: Continuous Integration:継続的インテグレーションの実践、ビルド、テスト、デプロイの参照。
- Google SRE Book:SLO、モニタリング、インシデント、ポストモーテム、信頼性の参照。
- Google SRE Book: Monitoring Distributed Systems:アラート、ダッシュボード、Four Golden Signalsを説明する一次参照。
- Google SRE Book: Service Level Objectives:SLI、SLO、SLAの区別と、利用者体験から信頼性目標を定義する参照。
- Google SRE Book: Postmortem Culture:インシデントを責任追及ではなく学習と再発防止へつなげる参照。
- OpenTelemetry: What is OpenTelemetry?:ログ、メトリクス、トレース、計装の共通語彙。
- OpenTelemetry: Signals:traces、metrics、logs、baggageなど、テレメトリ信号の役割を整理する参照。
- AWS App Runner: Observability for your service:App Runner serviceのlogs、metrics、events、CloudTrail、X-Ray tracingへの入口参照。
- Amazon CloudWatch User Guide: What is Amazon CloudWatch?:metrics、alarms、dashboards、logs、SLOなどAWS上の観測基盤の参照。
- Amazon CloudWatch Logs: Analyzing log data with Logs Insights:CloudWatch Logsの検索、集計、原因調査、修正検証に使う参照。
- NIST AI Risk Management Framework:AIのリスク、評価、ガバナンスを扱う参照。
- NIST AI RMF: Generative Artificial Intelligence Profile:生成AI固有のリスクをAI RMFへ対応づける参照。2026年6月時点ではNIST AI 600-1が公開版。
- OWASP Top 10 for Large Language Model Applications:プロンプトインジェクション、過信、過剰な権限などLLMアプリ固有のリスク参照。
- OWASP 2025 Top 10 Risk & Mitigations for LLMs and Gen AI Apps:2025版のprompt injection、sensitive information disclosure、excessive agency、misinformationなどの参照。
- OpenAI API Docs: Prompt engineering:promptを要件に合う出力を得るためのinstruction設計として扱う参照。
- OpenAI API Docs: Retrieval:検索で取り出した情報をモデル応答に組み合わせる考え方の参照。
- OpenAI API Docs: Function calling:tool callingやschemaに沿った外部機能呼び出しの参照。
- OpenAI API Docs: Evaluation best practices:AIシステムの出力をタスク固有のeval、rubric、test caseで測る参照。
- Claude Code Docs: Overview:Claude Codeがcodebaseを読み、file編集、command実行、開発tool連携を行うagentic coding toolであることの一次参照。
- Claude Code Docs: Common workflows:codebase探索、bug修正、refactoring、testing、PR、documentationなど日常開発workflowの公式参照。
- Claude Code Docs: Configure permissions:allow、ask、denyでtool permissionを管理し、sandboxとの関係を扱う公式参照。
- Claude Code Docs: Settings:managed、user、project、local scopeの使い分けと、team-shared settingsの参照。
- Claude Code Docs: Memory:CLAUDE.md、CLAUDE.local.md、memoryの読み込みと運用上の注意の参照。
- Claude Code Docs: Hooks:Claude Code lifecycleの特定時点でshell command、HTTP endpoint、LLM promptを実行するhookの参照。
- Claude Code Docs: Skills:繰り返し使う手順や専門的な作業能力をClaude Codeへ拡張するskillの参照。
- OpenAI Codex Docs: Overview:Codexがコード調査、実装、レビュー、debugなどを支援するcoding agentであることの一次参照。
- OpenAI Codex Docs: CLI:ローカルterminal上でCodexがコードを読み、変更し、commandを実行する利用形態の参照。
- OpenAI Codex Docs: Cloud tasks:Codexがcloud環境で背景タスクとして動くときの作業環境の参照。
- OpenAI Codex Docs: Agent approvals and security:Codexのapproval、sandbox、network、secretの扱いを説明する公式参照。
- OpenAI Codex Docs: Sandboxing:sandboxとapprovalを分けて考えるための公式参照。
- OpenAI Codex Docs: Permissions:Codexのlocal command execution、file write、networkなどのpermission profileを扱う参照。
- Michael Nygard: Documenting Architecture Decisions:ADRを小さな判断記録として残し、context、decision、status、consequencesを扱う原典的な参照。
- Google Engineering Practices: Writing good CL descriptions:変更説明を将来の読者にも分かる履歴として書くための参照。
- Google Engineering Practices: Small CLs:レビューしやすく、安全に戻しやすい小さな変更単位を扱う参照。
- Google for Developers: Technical Writing:技術文書の読者、構造、明確さを扱う教材参照。
- Diátaxis:チュートリアル、ハウツー、説明、リファレンスを分ける文書設計参照。