261006_01_ENH: 에이전트 참조 문서 합성 및 검증 기능 추가
This commit is contained in:
19
README.md
19
README.md
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user