From bbed607e5817b963369f73c6f5d6cb55aa6788b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EA=B2=BD=EC=A2=85?= Date: Mon, 8 Jun 2026 14:45:43 +0900 Subject: [PATCH] modify docu --- AGENTS.md | 8 ++++++++ docs/AGENT_RULES.md | 9 +++++++++ docs/PLAN.md | 8 ++++++++ docs/PROGRESS.md | 3 +++ 4 files changed, 28 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 0dfae51..2bc92b7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,6 +12,13 @@ FESA는 Abaqus, Nastran 같은 유한요소법 기반 구조해석 솔버를 C++ - HDF5 C library: 해석 결과와 reference 결과 저장 - Python 3: Harness, validation, phase execution, self-test +## Git 저장소 +- Canonical remote repository: `https://teagit.mimi1011.synology.me/baram2584/FESADev.git` +- 기본 remote 이름은 `origin`으로 사용한다. +- 현재 공유 기준 브랜치는 `dev`이며, 새 작업 브랜치는 특별한 지시가 없으면 `codex/` 형식을 사용한다. +- 새 환경에서 시작할 때는 `git remote -v`로 remote를 확인하고, 없으면 `git remote add origin https://teagit.mimi1011.synology.me/baram2584/FESADev.git`로 등록한다. +- push, tag, release, 외부 배포는 사용자가 명시적으로 요청하거나 승인한 경우에만 수행한다. + ## 기본 개발 워크플로우 솔버 기능 개발은 아래 순서를 기본으로 한다. @@ -121,5 +128,6 @@ Override variables: ## 커밋 및 문서화 - 커밋 전 hook은 Harness Python self-test와 workspace validation을 실행해야 한다. - 커밋 메시지는 conventional commits 형식을 따른다: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`. +- 커밋 전에는 `git status --short --branch`와 `git remote -v`로 작업 브랜치와 remote가 의도한 상태인지 확인한다. - 계획이 필요한 장기 작업은 Harness phase로 나누고, 각 step은 독립 실행 가능해야 한다. - Generated phase execution outputs remain ignored under `phases/**/step*-output.json`. diff --git a/docs/AGENT_RULES.md b/docs/AGENT_RULES.md index fc7024f..1e162f2 100644 --- a/docs/AGENT_RULES.md +++ b/docs/AGENT_RULES.md @@ -13,6 +13,15 @@ Before changing code or documents, every Agent must read: 5. `docs/AGENT_RULES.md` 6. The task-specific upstream documents under `docs/requirements/`, `docs/research/`, `docs/formulations/`, `docs/io-definitions/`, `docs/reference-models/`, `docs/implementation-plans/`, or related phase folders. +## Repository Defaults +- Canonical remote repository: `https://teagit.mimi1011.synology.me/baram2584/FESADev.git` +- Use `origin` as the default remote name. +- The current shared baseline branch is `dev`. +- Use `codex/` for new work branches unless the user requests a different branch. +- At session start, verify repository state with `git status --short --branch` and verify the remote with `git remote -v`. +- If a fresh checkout has no remote, add it with `git remote add origin https://teagit.mimi1011.synology.me/baram2584/FESADev.git`. +- Do not push, tag, release, or publish externally unless the user explicitly requests or approves it. + ## Global Solver Workflow All solver features follow this stage-gated workflow: diff --git a/docs/PLAN.md b/docs/PLAN.md index acc0252..902ca13 100644 --- a/docs/PLAN.md +++ b/docs/PLAN.md @@ -8,6 +8,12 @@ New Agents must read `AGENTS.md`, this file, `docs/PROGRESS.md`, `docs/WORKNOTE. ## Active Objective Build the FESA structural solver foundation around the initial feature `mitc4-linear-static-shell`. +## Repository Context +- Canonical remote repository: `https://teagit.mimi1011.synology.me/baram2584/FESADev.git` +- Default remote name: `origin` +- Shared baseline branch: `dev` +- New task branches should use `codex/` unless the user requests otherwise. + ## Current High-Level Plan 1. Maintain project-level documentation and handoff files. 2. Analyze new solver feature requirements for `mitc4-linear-static-shell`. @@ -26,12 +32,14 @@ Build the FESA structural solver foundation around the initial feature `mitc4-li - `python scripts/validate_workspace.py` remains the default validation path. - MITC4 reference comparison covers nodal displacement, reaction, element internal force/resultant, and stress. - Result comparison uses a single tolerance value `1e-5` with absolute-or-relative pass logic. +- Agents can identify the canonical git remote and shared baseline branch from the project handoff documents. ## Coordination Rules - Update this file when the plan, scope, ordering, or acceptance criteria change. - Update `docs/PROGRESS.md` after completing work or running validation. - Update `docs/WORKNOTE.md` after mistakes, failed approaches, environment traps, or decisions that future Agents should not rediscover. - Keep `.codex/agents/*.toml` and `.codex/skills/*/SKILL.md` pointed at `docs/AGENT_RULES.md` for common operating rules. +- Verify `git status --short --branch` and `git remote -v` at the start of git-aware work. ## Known Blockers - No CMake project exists yet, so `python scripts/validate_workspace.py` currently takes the no-op path. diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md index bf0a619..6f5b49a 100644 --- a/docs/PROGRESS.md +++ b/docs/PROGRESS.md @@ -20,6 +20,7 @@ - Updated `.codex/agents/*.toml`, `.codex/skills/*/SKILL.md`, and related tests to reference `docs/AGENT_RULES.md` instead of the solver agent design document. - Renamed the first solver development workflow stage to "새로운 솔버 기능 요구조건 분석" across `AGENTS.md`, `docs/`, `.codex/agents/requirement-agent.toml`, and `.codex/skills/fesa-requirements-baseline`. - Refined `requirement-agent` and `fesa-requirements-baseline` internals to describe a new solver feature requirements analysis document instead of a requirements drafting/specification task. +- Documented the canonical git remote `https://teagit.mimi1011.synology.me/baram2584/FESADev.git`, default remote `origin`, shared baseline branch `dev`, and `codex/` work branch convention in `AGENTS.md`, `docs/AGENT_RULES.md`, and `docs/PLAN.md`. ## In Progress - Ready for the next stage: new solver feature requirements analysis for `mitc4-linear-static-shell`. @@ -33,6 +34,8 @@ 6. Create `docs/implementation-plans/mitc4-linear-static-shell-implementation-plan.md`. ## Last Validation +- 2026-06-08: After documenting git repository settings, `python scripts/validate_workspace.py` passed through the expected no-op path because no root `CMakeLists.txt` exists yet. +- 2026-06-08: After documenting git repository settings, `git diff --check` passed with only Git line-ending normalization warnings. - 2026-06-08: After refining `requirement-agent` and `fesa-requirements-baseline` internals, `python C:\Users\baram\.codex\skills\.system\skill-creator\scripts\quick_validate.py .codex\skills\fesa-requirements-baseline` passed. - 2026-06-08: After refining `requirement-agent` and `fesa-requirements-baseline` internals, `python -m unittest discover -s scripts -p "test_*.py"` passed. 85 tests ran successfully. - 2026-06-08: After refining `requirement-agent` and `fesa-requirements-baseline` internals, `python scripts/validate_workspace.py` passed through the expected no-op path because no root `CMakeLists.txt` exists yet.