From 91a982039cf8e4a42640c9559a7415bb163f0ada Mon Sep 17 00:00:00 2001 From: tjtanjin Date: Sat, 18 Jul 2026 03:19:29 +0800 Subject: [PATCH] docs: point workspace guidance to acornops --- AGENTS.md | 7 +++++-- README.md | 5 ++++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d2170bc..05d1038 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,10 @@ Use this file as a map, not as the full source of truth. The repository knowledg This repository supports human and agent-assisted development. When using a coding agent directly inside this repo, start from this repository root and read this file before editing files. -For work that touches multiple AcornOps repositories, start the agent from the `acornops-workspace` root instead. The workspace root contains the cross-repo manifest, shared skills, validation helpers, and PR coordination workflow. +For work that touches multiple AcornOps repositories, start the agent from the +AcornOps workspace root instead. The workspace root is cloned from the +`acornops` repository and contains the cross-repo manifest, shared skills, +validation helpers, and PR coordination workflow. ## Start Here @@ -40,7 +43,7 @@ For work that touches multiple AcornOps repositories, start the agent from the ` - If work spans multiple steps or design decisions, create an execution plan in `docs/exec-plans/active/`. - Shared skills live in `.agents/skills/shared`; repository-owned skills live in `.agents/skills/local`. - Agent tools may not auto-discover nested skills. When a task matches a skill description, open the relevant `SKILL.md` from `.agents/skills/shared` or `.agents/skills/local` before editing. -- Do not edit `.agents/skills/shared` here; update shared skills in the parent `acornops-workspace` repo and sync them into this repo. +- Do not edit `.agents/skills/shared` here; update shared skills in the parent `acornops` repository and sync them into this repo. - Follow [Agent Handoff](docs/AGENT_HANDOFF.md) before final response, commit, or pull request handoff. - Keep this harness vendor-neutral; do not add required vendor-specific instruction files. diff --git a/README.md b/README.md index 33d41c1..31e796a 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,10 @@ This repository owns the execution-engine service code, production image, health ## Agent-Assisted Development -This repository supports human and agent-assisted development. Start coding agents from this repository root for execution-engine-only work, and from the `acornops-workspace` root for changes that touch multiple AcornOps repositories. +This repository supports human and agent-assisted development. Start coding +agents from this repository root for execution-engine-only work, and from the +AcornOps workspace cloned from the [`acornops`](https://github.com/acornops/acornops) +repository for changes that touch multiple AcornOps repositories. ## Contracts