目的

備忘。

用途

Codexを使用する際に設定する。
プロジェクトでAIやエージェントにどう動いてほしいかを書く方針ファイルのこと。

# AGENTS.md

## Project overview(PJ概要)
このプロジェクトは、在庫管理や販売管理を行う業務システムです。  
受注、出荷、請求、在庫更新などの基本業務を扱います。  
現場で使いやすく、迷わず操作できることを重視します。  

## Core principles(基本原則)
できる限りシンプルな画面と操作を優先します。  
複雑な仕組みよりも、理解しやすく維持しやすい設計を選びます。  
業務が正しく安全に回ることを最優先にします。  

## Domain rules(業務ルール)
受注・出荷・請求の流れは、業務上の前後関係を守って扱います。  
数量、単価、金額などの重要データは正確に保持します。  
過去の伝票内容は、後から見返しても意味が変わらないようにします。  

## UI/UX policy(画面方針)
入力項目は必要最小限にし、迷わない構成にします。  
ボタン名や表示文言は、現場担当者が直感的に理解できる表現にします。  
1画面で完結できる作業は、できるだけ1画面で完結させます。  

## Technical guidelines(技術ガイドライン)
実装は可読性を重視し、複雑すぎる書き方を避けます。  
命名は統一し、見ただけで役割が分かるようにします。  
将来の改修で困らないように、責務を分けて実装します。  

## Implementation priorities(実装優先順位)
まずは業務に必須な基本機能から実装します。  
見た目の細かい調整よりも、正しく動くことを優先します。  
一度に広げすぎず、段階的に確認しながら進めます。  

## What agents should do(エージェントがすべきこと)
要件や既に決まっている方針を踏まえて提案します。  
できるだけ具体例を交えて、分かりやすく説明します。  
利用者がすぐ判断できるように、選択肢の違いも明確にします。  

## What agents should avoid(エージェントが避けるべきこと)
未確定事項を、確定事項のように断定しないでください。  
不要に複雑な設計や、現場運用に合わない提案は避けてください。  
既に決まっている方針と矛盾する案を、無自覚に出さないでください。  

## Output style(AIの出力スタイル)
説明は短く整理し、必要に応じて理由も添えてください。  
専門用語を使う場合は、初学者にも分かるように補足してください。  
すぐ使える形の文章、表、コード例を優先して出力してください。  

## Current important decisions(既に決まっていること)
このプロジェクトでは、できる限りシンプルな運用を重視します。  
販売管理機能は、GUIや操作を増やしすぎない方針で進めます。  
実装や提案の際は、この方針を前提として扱ってください。  

終わり

適宜更新していこっと。

コメント

タイトルとURLをコピーしました