Skip to content

Commit bfd9a93

Browse files
committed
docs: drop references to gitignored plan file
1 parent 580b612 commit bfd9a93

10 files changed

Lines changed: 17 additions & 19 deletions

File tree

.agents/schemas/evidence.schema.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
},
2121
"protocol": {
2222
"type": "string",
23-
"description": "Transport protocol of the target. SSH and HTTP only — telnet is out of scope for the agent skill system (see agent-skills-plan.md §2).",
23+
"description": "Transport protocol of the target. SSH and HTTP only — telnet is out of scope for the agent skill system.",
2424
"enum": ["ssh", "http"]
2525
},
2626
"target": {
@@ -82,7 +82,7 @@
8282
},
8383
"probes": {
8484
"type": "array",
85-
"description": "Ordered record of probes executed. Each entry is a single probe step. Read-only probes record observations; destructive probes additionally record the explicit per-probe consent given by the operator (see probe-safety contract in agent-skills-plan.md §5).",
85+
"description": "Ordered record of probes executed. Each entry is a single probe step. Read-only probes record observations; destructive probes additionally record the explicit per-probe consent given by the operator (see the probe-safety contract in target-probing/SKILL.md).",
8686
"items": {
8787
"$ref": "#/definitions/probeRecord"
8888
}
@@ -203,7 +203,7 @@
203203
},
204204
"sshFindings": {
205205
"type": "object",
206-
"description": "TODO: SSH-specific finding shapes. Locked down in Phase 3 once the target-probing SSH playbooks are authored against a real target. Fields below are the categories the playbook MUST cover (per agent-skills-plan.md §5); their internal shape is intentionally permissive in v0.",
206+
"description": "SSH-specific finding shapes. Fields below are the categories the playbook MUST cover; their internal shape is intentionally permissive in v0 and will be tightened once more SSH targets have been probed.",
207207
"additionalProperties": false,
208208
"properties": {
209209
"shellPrompt": {
@@ -230,7 +230,7 @@
230230
},
231231
"httpFindings": {
232232
"type": "object",
233-
"description": "TODO: HTTP-specific finding shapes. Locked down in Phase 3 once the target-probing HTTP playbooks are authored against a real target. Fields below are the categories the playbook MUST cover (per agent-skills-plan.md §5); their internal shape is intentionally permissive in v0.",
233+
"description": "HTTP-specific finding shapes. Fields below are the categories the playbook MUST cover; their internal shape is intentionally permissive in v0 and will be tightened once more HTTP targets have been probed.",
234234
"additionalProperties": false,
235235
"properties": {
236236
"authScheme": {

.agents/skills/script-authoring/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Four pattern sub-recipes cover the supported transports:
2929
- [`http-api`](#http-api)
3030
- [`http-form-fill`](#http-form-fill)
3131

32-
Telnet/TN3270 is out of scope (`agent-skills-plan.md` §2). The recipes below are starting points; pick one based on [`strategy-selection`](../strategy-selection/SKILL.md) output and adapt it.
32+
Telnet/TN3270 is out of scope for the agent skill system. The recipes below are starting points; pick one based on [`strategy-selection`](../strategy-selection/SKILL.md) output and adapt it.
3333

3434
## Modes
3535

@@ -62,7 +62,7 @@ A green local schema check proves the JSON parses and conforms to the schema. It
6262
- `Send` / `Receive` ordering that drifts out of sync with the actual prompt.
6363
- Status messages emitted in the wrong order or at the wrong phase.
6464

65-
Before declaring a draft "ready to import," cross-reference an analogous sample from `samples-index.md`. If a sample uses a construct your draft does not (e.g., a `Try`/`Catch` around `Disconnect`, a `Receive` flush of the login banner, a `Headers` block before `HttpAuth`), surface that divergence to the operator rather than silently omitting it. The `agent-skills-plan.md` §5 rule is explicit: *"if a sample uses a construct the draft doesn't, surface the divergence."*
65+
Before declaring a draft "ready to import," cross-reference an analogous sample from `samples-index.md`. If a sample uses a construct your draft does not (e.g., a `Try`/`Catch` around `Disconnect`, a `Receive` flush of the login banner, a `Headers` block before `HttpAuth`), surface that divergence to the operator rather than silently omitting it.
6666

6767
## Conventions all four patterns share
6868

.agents/skills/target-probing/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Before running any probe, consult [`AGENTS.md`](../../../AGENTS.md) for the acti
1818

1919
## Scope
2020

21-
Local-shell recon recipes against a live target with a service-account credential. SSH and HTTP only — telnet/TN3270 is out of scope (`agent-skills-plan.md` §2). Probing produces a structured **evidence artifact** that conforms to [`.agents/schemas/evidence.schema.json`](../../../.agents/schemas/evidence.schema.json) and is consumed by [`strategy-selection`](../strategy-selection/SKILL.md) and [`script-authoring`](../script-authoring/SKILL.md).
21+
Local-shell recon recipes against a live target with a service-account credential. SSH and HTTP only — telnet/TN3270 is out of scope for the agent skill system. Probing produces a structured **evidence artifact** that conforms to [`.agents/schemas/evidence.schema.json`](../../../.agents/schemas/evidence.schema.json) and is consumed by [`strategy-selection`](../strategy-selection/SKILL.md) and [`script-authoring`](../script-authoring/SKILL.md).
2222

2323
This skill calls `ssh`, `curl`/`Invoke-WebRequest`, etc. directly from the operator's machine. It does **not** mediate probes through SPP.
2424

@@ -29,7 +29,7 @@ This skill calls `ssh`, `curl`/`Invoke-WebRequest`, etc. directly from the opera
2929

3030
## Probe-safety contract (mandatory)
3131

32-
All six items below are non-negotiable. They restate `agent-skills-plan.md` §5 in skill-local form so the agent enforces them at execution time, not just at planning time.
32+
All six items below are non-negotiable. The agent enforces them at execution time, not just at planning time.
3333

3434
1. **Read-only by default.** Probes that only observe — banner grab, `WWW-Authenticate` header inspection, `whoami`, `id`, `uname`, GET on a documented API endpoint, login-form HTML inspection — run without per-probe confirmation.
3535
2. **Destructive probes that go beyond the service account require explicit per-probe operator opt-in.** Key install, account create/delete, sudo-that-mutates non-service-account state, POST/PUT/DELETE against undocumented endpoints — each is presented to the operator with a one-line *"what this will do, what could go wrong"* summary and proceeds only on explicit consent. Consent is **per probe, not per session**. Record the consent timestamp and the summary that was shown in the evidence artifact (`probeRecord.consent.grantedAt`, `probeRecord.consent.summaryShown` — see [`.agents/schemas/evidence.schema.json`](../../../.agents/schemas/evidence.schema.json) lines 173–188).

.agents/skills/task-log-analysis/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,9 @@ Do not paraphrase the messages; quote them verbatim. The catalog below matches o
8282

8383
## Failure-pattern catalog
8484

85-
The catalog is [`docs/agent-reference/failure-patterns.md`](../../../docs/agent-reference/failure-patterns.md). Per [`agent-skills-plan.md`](../../../agent-skills-plan.md) §5 and §6 Phase F, it **ships empty**. Rows are added only from real extended task logs captured during the maiden voyage and subsequent runs; rows mined from prose guides or invented from memory are explicitly not acceptable.
85+
The catalog is [`docs/agent-reference/failure-patterns.md`](../../../docs/agent-reference/failure-patterns.md). It **ships empty by design**. Rows are added only from real extended task logs; rows mined from prose guides or invented from memory are explicitly not acceptable.
8686

87-
When the catalog is empty (Phase 1 state), this skill falls back to the classification flow above and asks the operator for guidance on signatures it has not seen before. When it has rows, this skill matches the extracted signature substring against the `signature` column and surfaces the recommended fix; an exact-or-near match shortens the next iteration to a targeted change.
87+
When the catalog is empty, this skill falls back to the classification flow above and asks the operator for guidance on signatures it has not seen before. When it has rows, this skill matches the extracted signature substring against the `signature` column and surfaces the recommended fix; an exact-or-near match shortens the next iteration to a targeted change.
8888

8989
If a real failure is observed that the catalog does not cover, the agent **proposes a new row** at the end of the loop — signature, phase, likely cause, recommended fix, first-observed date and target type — and asks the operator to confirm before adding it. Confirmation lives outside this skill (the row is added to `failure-patterns.md` by hand or in a follow-up commit).
9090

AGENTS.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ This file is the agent orchestrator. Read it first.
77
## Project structure
88

99
- `AGENTS.md` (this file) — orchestrator: workflows + routing table.
10-
- `agent-skills-plan.md` — master plan for the agent skill system.
1110
- `.agents/``skills/` (one subdirectory per capability skill, each with a `SKILL.md`), `schemas/evidence.schema.json` (probing-evidence contract), `prompts/` (per-phase implementation prompts), `CONVENTIONS.md`.
1211
- `schema/custom-platform-script.schema.json` — authoritative platform-script schema.
1312
- `samples/` — tested production-grade samples (ssh, http, telnet).

docs/agent-reference/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
This directory holds machine-first reference material for the agent skill system. It is cited from `AGENTS.md` and from individual `SKILL.md` files under `.agents/skills/`.
66

7-
Human-facing documentation lives in `docs/concepts/`, `docs/guides/`, `docs/tutorials/`, `docs/reference/`, and `docs/quick-start/` and is not duplicated here. Per `agent-skills-plan.md` §5, agent-only content stays out of human-facing locations.
7+
Human-facing documentation lives in `docs/concepts/`, `docs/guides/`, `docs/tutorials/`, `docs/reference/`, and `docs/quick-start/` and is not duplicated here. Agent-only content stays out of human-facing locations.
88

99
## Files
1010

docs/agent-reference/samples-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ CI runs the same script with `-CheckOnly` and fails the build if the committed c
1717
- **operations** — intersection of top-level keys with the canonical operation list from `schema/custom-platform-script.schema.json`. Imports and user-defined functions never appear here.
1818
- **OS-family** — intentionally blank. Phase 1 prefers blank over guessed values; revisit in a later phase if needed.
1919
- **file-path** and **README** — filesystem facts. `` means the field could not be determined.
20-
- `samples/telnet/` is excluded — telnet is out of scope for the agent skill system (see `agent-skills-plan.md` §2). The samples remain in the repo for human reference.
20+
- `samples/telnet/` is excluded — telnet is out of scope for the agent skill system. The samples remain in the repo for human reference.
2121

2222
## Samples
2323

docs/agent-reference/strategy-decision-tree.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Backs the `strategy-selection` skill. Maps `(protocol, vendor docs, probe eviden
99
- `http-api`
1010
- `http-form-fill`
1111

12-
Telnet/TN3270 are out of scope for agent skills (see `agent-skills-plan.md` §2). The repository's human-facing telnet material remains under `samples/telnet/` and `docs/`.
12+
Telnet/TN3270 are out of scope for the agent skill system. The repository's human-facing telnet material remains under `samples/telnet/` and `docs/`.
1313

1414
## Source documents
1515

tools/Build-SamplesIndex.ps1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@
66
77
.DESCRIPTION
88
Walks samples/ssh, samples/http, and templates/ (samples/telnet is
9-
excluded from the agent-facing index per agent-skills-plan.md §2 —
10-
telnet is out of scope for the agent skill system). For every JSON
9+
excluded from the agent-facing index — telnet is out of scope for
10+
the agent skill system). For every JSON
1111
file found, emits one row in the index with the columns:
1212
1313
protocol | auth-scheme | operations | OS-family | file-path | README
@@ -286,7 +286,7 @@ CI runs the same script with `-CheckOnly` and fails the build if the committed c
286286
- **operations** — intersection of top-level keys with the canonical operation list from `schema/custom-platform-script.schema.json`. Imports and user-defined functions never appear here.
287287
- **OS-family** — intentionally blank. Phase 1 prefers blank over guessed values; revisit in a later phase if needed.
288288
- **file-path** and **README** — filesystem facts. `—` means the field could not be determined.
289-
- `samples/telnet/` is excluded — telnet is out of scope for the agent skill system (see `agent-skills-plan.md` §2). The samples remain in the repo for human reference.
289+
- `samples/telnet/` is excluded — telnet is out of scope for the agent skill system. The samples remain in the repo for human reference.
290290
291291
## Samples
292292

tools/README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -376,8 +376,7 @@ Connect-Safeguard -Appliance 192.168.117.15 -Insecure -DeviceCode
376376

377377
* PowerShell 7.6.2
378378
* `safeguard-ps` 8.4.3 (minimum — enforced at script start; earlier versions lack `-ExtendedLogging` on `Invoke-SafeguardAssetSshHostKeyDiscovery`)
379-
* SPP appliance reachable at the time of authoring (Phase 2 of agent-skills
380-
initiative; see `agent-skills-plan.md`).
379+
* SPP appliance reachable at the time of authoring.
381380

382381
### Cmdlet citations
383382

0 commit comments

Comments
 (0)