261006_01_ENH: 에이전트 참조 문서 합성 및 검증 기능 추가

This commit is contained in:
2026-10-06 10:19:14 +09:00
parent 74d8ec48d2
commit 4ec2ef8bb7
17 changed files with 1435 additions and 66 deletions

View File

@@ -1,6 +1,6 @@
# KRI Agent Harness
This repository composes deterministic, self-contained `AGENTS.md` and paired `CLAUDE.md` files for repositories under the KRI development workspace.
This repository composes deterministic `AGENTS.md`, paired `CLAUDE.md`, managed workflow skills, and shared-contract reference copies for repositories under the KRI development workspace.
## Requirements
@@ -27,7 +27,7 @@ Run commands from this repository root:
The `.cmd` launcher invokes the PowerShell wrapper with a process-scoped execution-policy bypass. It does not change the user or machine execution policy. When local scripts are already allowed, `scripts\agent-harness.ps1` may be called directly.
`plan`, `verify`, and `list` are read-only. `compose` writes only generated `AGENTS.md` and `CLAUDE.md`. `register` writes `workspace.local.yml` by default; `register --shared` writes `workspace.yml`. No command performs Git, database, deployment, or network operations.
`plan`, `verify`, and `list` are read-only. `compose` writes generated `AGENTS.md`, `CLAUDE.md`, managed skills under `.agents/skills` and `.claude/skills`, and shared references under `.agent-harness/references`. It refuses to overwrite an unmanaged file. `register` writes `workspace.local.yml` by default; `register --shared` writes `workspace.yml`. No command performs Git, database, deployment, or network operations.
Use `--contract <contract-id>` to select the registered provider first and then only registered consumers of that contract, ordered by project ID. Use `--all` only when every registered project is intentionally in scope. `--project`, `--contract`, and `--all` are mutually exclusive.
@@ -43,11 +43,24 @@ Use `--contract <contract-id>` to select the registered provider first and then
Each managed repository owns:
- `.agent/profile.yml`
- `.agent/project.md`
- `.agent/project.md` as the concise task-to-reference router
- `.agent/references/*.md` for repository-specific detail
- `.agent/consumer.md` when it provides a shared contract
- `.agent/consumer-references/*.md` for detailed shared consumer contracts
Edit source inputs, run `plan`, obtain the required approval, then run `compose`. Use `verify` to detect stale generated output.
Every `project.md` must contain `## Required Project References`. Each Markdown file under `.agent/references` must be routed from that section using a repository-relative backticked path. Reference-only content changes do not require recomposition when routing is unchanged, but `verify` still validates existence, containment, strict UTF-8, and routing completeness.
## Managed Skills
The harness owns canonical skill sources under `skills/<skill-name>/SKILL.md` and composes identical managed copies for both supported agents:
- Codex: `.agents/skills/<skill-name>/SKILL.md`
- Claude Code: `.claude/skills/<skill-name>/SKILL.md`
The managed set includes `project-reference-loader`, which reloads only the current references matching each substantive task.
## Development
On Windows PowerShell, use `npm.cmd` because the `npm.ps1` shim may be blocked by execution policy: