Skip to content

Commit fe1e2a2

Browse files
Copilotpelikhan
andauthored
docs: add §6.4 initial prompt context — no predefined context, all imports must be declared
Agent-Logs-Url: https://github.com/github/gh-aw/sessions/8df5106a-c84d-4c72-b43d-280243d2ebae Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
1 parent 678615c commit fe1e2a2

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

specs/aw-harness.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -451,6 +451,22 @@ A conforming implementation **MUST** extract steps from the workflow document bo
451451
4. Steps without a `<!-- harness-step -->` annotation are treated as sequential steps in document order.
452452
5. If no `harness:` block is present in the frontmatter, the entire document body **MUST** be treated as a single step with no explicit agent or dependency.
453453
454+
### 6.4 Initial Prompt Context
455+
456+
The AW Harness **MUST NOT** inject any predefined or ambient context into agent sessions. There are no implicit files, skills, or instruction documents automatically added to a session's initial prompt.
457+
458+
A conforming implementation **MUST** source every item included in a session's initial prompt from one of the following explicitly declared origins:
459+
460+
- The step's own Markdown body (extracted per [Section 6.3](#63-step-extraction-algorithm)).
461+
- Transcripts from upstream steps (passed via the DAG execution model in [Section 7](#7-dag-execution-model)).
462+
- The agent's `system` prompt as declared under `harness.agents` in the frontmatter.
463+
- Files or sub-workflows declared via the standard `imports:` frontmatter key.
464+
465+
A conforming implementation **MUST NOT** automatically load AGENTS.md files, `.github/agents/` entries, skills directories, or any other ambient repository files unless they are explicitly listed in `imports:`. This behavior is a deliberate divergence from engines such as `engine: copilot` that inject ambient context automatically.
466+
467+
> [!IMPORTANT]
468+
> Workflow authors **MUST** explicitly declare every file or skill they wish the agent to reference using the `imports:` frontmatter key. Relying on ambient context that is auto-injected by other engines will produce a missing-context failure when running with `engine: aw`.
469+
454470
---
455471
456472
## 7. DAG Execution Model

0 commit comments

Comments
 (0)