> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md).

# Implementation Notes

**Session ID**: `phase08-session01-release-requirements-and-risk-baseline` **Package**: Cross-cutting **Started**: 2026-05-31 00:15 **Last Updated**: 2026-05-31 02:12

***

## Session Progress

| Metric              | Value     |
| ------------------- | --------- |
| Tasks Completed     | 19 / 19   |
| Estimated Remaining | 0 minutes |
| Blockers            | 0         |

***

### Task T019 - Record outcomes and handoff

**Started**: 2026-05-31 02:05 **Completed**: 2026-05-31 02:12 **Duration**: 7 minutes

**Notes**:

* Recorded final command outcomes, docs review results, changed files, residual risks, and Session 02 handoff below.
* Marked the task checklist and completion checklist ready for the validate workflow step.

**Files Changed**:

* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - added final outcome and handoff sections.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T019 and the completion checklist complete.

***

## Command Outcomes

| Check                       | Result | Notes                                                                                                                                                                                          |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Analyzer                    | PASS   | Bundled analyzer resolved current session `phase08-session01-release-requirements-and-risk-baseline`; local `.spec_system/scripts` directory is absent.                                        |
| Prerequisites               | PASS   | Bundled prerequisite checker passed spec-system, `jq`, `git`, and npm workspace checks.                                                                                                        |
| Consistency scan            | PASS   | No unfinished placeholders or stale Phase 07 ownership wording remained in touched artifacts.                                                                                                  |
| Docs path review            | PASS   | Corrected pre-existing archived Phase 02/05/06/07 references; rerun found no missing file references in scoped docs, excluding commands, wildcards, home paths, and ignored `EXAMPLES/` paths. |
| Decommission wording review | PASS   | Matrix and stable docs remain candidate-only and require Session 07 final disposition before deletion or reduction.                                                                            |
| ASCII scan                  | PASS   | No non-ASCII characters found in session outputs or touched docs.                                                                                                                              |
| LF scan                     | PASS   | No CRLF endings found in session outputs or touched docs.                                                                                                                                      |
| Trailing whitespace scan    | PASS   | No trailing whitespace found in session outputs or touched docs.                                                                                                                               |
| `git diff --check`          | PASS   | No whitespace errors.                                                                                                                                                                          |

No application tests were run because this session changed Markdown/spec artifacts only and did not alter runtime behavior.

## Docs Review Results

* Phase 08 baseline artifacts are linked from the master PRD, Phase 08 PRD, release docs, hosted-services docs, privacy/security docs, deployment docs, environment docs, architecture docs, legacy consolidation docs, and affected package READMEs.
* Release claim gates now distinguish shipped, guardrail, planned, disabled, unavailable, evidence-only, no-claim, and blocked states.
* Stable docs preserve no-overclaim wording for hosted identity, hosted storage, analytics, public replay, push, remote access, production-hosted validation, certification, media readiness, trusted erasure, and decommission.
* Decommission entries remain candidate-only and do not authorize deletion.

## Changed Files

### Created

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md`
* `.spec_system/PRD/phase_08/phase08_requirement_routing_matrix.md`
* `.spec_system/PRD/phase_08/phase08_release_risk_matrix.md`
* `.spec_system/PRD/phase_08/decommission_approval_matrix.md`
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md`

### Modified

* `.spec_system/PRD/PRD.md`
* `.spec_system/PRD/PRD_UX.md`
* `.spec_system/PRD/phase_08/PRD_phase_08.md`
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md`
* `docs/release.md`
* `docs/deployment.md`
* `docs/hosted-services.md`
* `docs/privacy-and-security.md`
* `docs/ARCHITECTURE.md`
* `docs/environments.md`
* `docs/legacy-consolidation.md`
* `packages/protocol/README_protocol.md`
* `apps/server/README_server.md`
* `apps/web/README_web.md`
* `apps/warroom/README_warroom.md`
* `apps/cli/README_cli.md`

## Residual Risks

* Trusted unified erasure remains unimplemented and routed to Sessions 02-04.
* Hosted identity remains planned/unavailable unless Session 04 validates active hosted auth or records explicit no-claim release wording.
* Production-hosted validation remains incomplete until Session 05 records sanitized deployed target evidence or unavailable no-claim evidence.
* Mobile/accessibility evidence remains local-browser evidence until Session 06 records release evidence and any certification limits.
* Media expansion and legacy deletion remain blocked until Session 07 approves dispositions and reruns affected gates.
* Final release readiness remains blocked until Session 08 runs release gates and synchronizes security/docs posture.

## Session 02 Handoff

Session 02 should start from:

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md`
* `.spec_system/PRD/phase_08/phase08_requirement_routing_matrix.md`
* `.spec_system/PRD/phase_08/phase08_release_risk_matrix.md`

The first implementation focus is P08-R003 and P08-R004: create a complete release-scoped erasure boundary inventory and shared protocol-owned erasure vocabulary for dry-run, confirmation, partial failure, audit, verification, idempotency, and unsupported claims. Session 02 must not perform destructive deletion and must keep cleanup, reset, leave, diagnostics recovery, and one-boundary deletion distinct from trusted unified erasure.

***

## Validate Workflow

**Completed**: 2026-05-31

**Result**: PASS

**Notes**:

* Validation reran the workspace test suite, `git diff --check`, ASCII/LF spot checks, and session task completion checks.
* `security-compliance.md` was created for the session as required by the validate workflow.
* No additional implementation changes were needed during validation.

***

### Task T018 - Validate whitespace, ASCII, LF, and diff checks

**Started**: 2026-05-31 01:58 **Completed**: 2026-05-31 02:05 **Duration**: 7 minutes

**Notes**:

* Ran `git diff --check` with no whitespace errors.
* Ran scoped `git diff --check` over session outputs and touched docs with no whitespace errors.
* Ran ASCII, CRLF, and trailing-whitespace scans over session outputs and touched docs. No non-ASCII characters, CRLF endings, or trailing whitespace were found.
* No app tests were required because this session changed documentation and spec artifacts only.

**Files Changed**:

* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded command outcomes.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T018 complete and updated progress summary.

***

### Task T017 - Run docs link/path and decommission review

**Started**: 2026-05-31 01:48 **Completed**: 2026-05-31 01:58 **Duration**: 10 minutes

**Notes**:

* Ran a backtick path review across the Phase 08 artifacts and touched docs/READMEs. The review surfaced older stale references to archived Phase 02, 05, 06, and 07 artifacts; corrected those to `.spec_system/archive/...` paths.
* Reran the path review after correction with no missing file references found, excluding intentional command strings, wildcard examples, home-directory examples, and ignored `EXAMPLES/` paths.
* Verified the decommission matrix and stable docs still state candidate inventory/no deletion approval and require Session 07 final dispositions.

**Files Changed**:

* `.spec_system/PRD/PRD.md` - corrected archived Phase 06 session reference.
* `docs/legacy-consolidation.md` - corrected archived Phase 02 references.
* `docs/environments.md`, `docs/ARCHITECTURE.md`, `docs/privacy-and-security.md`, `docs/hosted-services.md`, `docs/release.md`, `docs/deployment.md`, `apps/warroom/README_warroom.md` - corrected archived Phase 05/06/07 references.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded review results.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T017 complete and updated progress summary.

***

### Task T016 - Run consistency scan

**Started**: 2026-05-31 01:41 **Completed**: 2026-05-31 01:48 **Duration**: 7 minutes

**Notes**:

* Ran `rg` scans across Phase 08 artifacts, stable docs, apps, and packages for stale Phase 07 ownership wording, unfinished placeholder text, release-claim overstatements, no-claim coverage, owner session routing, and decommission/certification wording.
* Confirmed the new artifacts route P08-R001 through P08-R020, risks P08-RISK-001 through P08-RISK-012, and owner sessions S0802 through S0808.
* No stale `owned by later Phase 07` or unfinished `To be completed` placeholders remained in the touched artifacts.

**Files Changed**:

* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded scan results.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T016 complete and updated progress summary.

***

### Task T015 - Update affected package READMEs

**Started**: 2026-05-31 01:32 **Completed**: 2026-05-31 01:41 **Duration**: 9 minutes

**Notes**:

* Updated package READMEs where Phase 08 Session 01 baseline routing affects release-sensitive package boundaries.
* `apps/hooks/README_hooks.md` and `apps/adapters/README_adapters.md` were reviewed and left unchanged because their current wording already preserves local-only/outbound-only boundaries and does not imply hosted identity, trusted erasure, production validation, certification, media readiness, or decommission completion.

**Files Changed**:

* `packages/protocol/README_protocol.md` - added Phase 08 routing and protocol-first trusted-erasure ownership.
* `apps/server/README_server.md` - added Phase 08 no-overclaim server boundary for diagnostics, recovery, exports, archives, hosted posture, and health checks.
* `apps/web/README_web.md` - added Phase 08 release UX boundary for erasure UX, hosted identity copy, production validation, and certification wording.
* `apps/warroom/README_warroom.md` - replaced stale Phase 07/08 ownership wording with Phase 08 owner sessions and no-claim baseline.
* `apps/cli/README_cli.md` - added Phase 08 CLI-adjacent erasure claim gate wording.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T015 complete and updated progress summary.

***

### Task T014 - Update stable release docs

**Started**: 2026-05-31 01:23 **Completed**: 2026-05-31 01:32 **Duration**: 9 minutes

**Notes**:

* Added stable-doc references to the Phase 08 baseline artifacts, routing, risk ownership, production-hosted no-claim behavior, hosted-service claim gates, environment boundaries, and candidate-only decommission matrix.
* Preserved current no-overclaim wording: Session 01 artifacts do not prove trusted erasure, hosted identity, production validation, certification, media readiness expansion, release completion, or deletion approval.

**Files Changed**:

* `docs/release.md` - linked Session 01 artifacts and candidate-only decommission matrix.
* `docs/deployment.md` - added Session 05 production-hosted validation routing and no-claim wording.
* `docs/hosted-services.md` - added Phase 08 claim baseline references.
* `docs/privacy-and-security.md` - linked risk and claim-gate baselines under open release risks.
* `docs/ARCHITECTURE.md` - added documentation-only Phase 08 baseline architecture note.
* `docs/environments.md` - added environment claim gate wording.
* `docs/legacy-consolidation.md` - linked the candidate-only decommission matrix.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T014 complete and updated progress summary.

***

### Task T013 - Update PRD and UX PRD links

**Started**: 2026-05-31 01:16 **Completed**: 2026-05-31 01:23 **Duration**: 7 minutes

**Notes**:

* Linked the four Session 01 baseline artifacts from the master PRD and Phase 08 PRD.
* Added UX release gate language for local erasure states, hosted identity no-overclaim wording, mobile/accessibility evidence classes, production-hosted evidence, and candidate-only media/decommission behavior.
* Updated Phase 08 status wording to show Session 01 implementation artifacts exist but validation is still pending.

**Files Changed**:

* `.spec_system/PRD/PRD.md` - linked Session 01 artifacts and updated Phase 08 status language.
* `.spec_system/PRD/PRD_UX.md` - added Phase 08 Release UX Gates.
* `.spec_system/PRD/phase_08/PRD_phase_08.md` - linked baseline artifacts and updated session status wording.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T013 complete and updated progress summary.

***

### Task T012 - Finalize decommission approval matrix

**Started**: 2026-05-31 01:13 **Completed**: 2026-05-31 01:16 **Duration**: 3 minutes

**Notes**:

* Marked the decommission matrix complete as a candidate inventory only and added a summary handoff for Session 07.
* Preserved explicit no-deletion-approved wording for historical findings, copied bundles, reports, ignored media intake, generated drafts, sensitive service-discovery evidence, `docs/PROGRESS.md`, and archived spec-system records.

**Files Changed**:

* `.spec_system/PRD/phase_08/decommission_approval_matrix.md` - finalized candidate inventory status and Session 07 handoff summary.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T012 complete and updated progress summary.

***

### Task T011 - Finalize release risk matrix

**Started**: 2026-05-31 01:10 **Completed**: 2026-05-31 01:13 **Duration**: 3 minutes

**Notes**:

* Marked the risk matrix complete for Session 01 and added traceability from open security findings, media blockers, hosted guardrails, and legacy deletion gates to risk rows and owner sessions.
* Kept all findings open until later owner sessions produce evidence and Session 08 synchronizes final posture.

**Files Changed**:

* `.spec_system/PRD/phase_08/phase08_release_risk_matrix.md` - finalized status and finding traceability.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T011 complete and updated progress summary.

***

### Task T010 - Finalize requirement routing matrix

**Started**: 2026-05-31 01:06 **Completed**: 2026-05-31 01:10 **Duration**: 4 minutes

**Notes**:

* Marked the routing matrix complete for Session 01 and added a coverage review mapping requirements to release baseline/final closeout, erasure, hosted identity, production validation, mobile/accessibility, media, and decommission owners.
* Confirmed no Phase 08 release requirement is intentionally unrouted; out-of-scope hosted activation and formal certification claims remain explicit deferrals.

**Files Changed**:

* `.spec_system/PRD/phase_08/phase08_requirement_routing_matrix.md` - finalized status and coverage review.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T010 complete and updated progress summary.

***

### Task T009 - Finalize release baseline artifact

**Started**: 2026-05-31 01:00 **Completed**: 2026-05-31 01:06 **Duration**: 6 minutes

**Notes**:

* Completed the release baseline with source evidence, local-first constraints, claim gates, evidence standards, Phase 08 ownership, and residual-risk wording.
* Kept all stronger claims gated to owning sessions and marked Session 01 as planning evidence only.

**Files Changed**:

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md` - finalized Session 01 baseline content.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T009 complete and updated progress summary.

***

### Task T008 - Define claim vocabulary and evidence standards

**Started**: 2026-05-31 00:53 **Completed**: 2026-05-31 01:00 **Duration**: 7 minutes

**Notes**:

* Added claim-state vocabulary, minimum evidence standards by claim type, no-overclaim rules, and sanitized-output requirements.
* Explicitly separated guardrail, planned, disabled, unavailable, evidence-only, no-claim, and blocked states for use by later Phase 08 sessions.

**Files Changed**:

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md` - added evidence standards, no-overclaim rules, and sensitive-output constraints.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T008 complete and updated progress summary.

***

### Task T007 - Inventory decommission candidates

**Started**: 2026-05-31 00:46 **Completed**: 2026-05-31 00:53 **Duration**: 7 minutes

**Notes**:

* Added candidate-only decommission entries for historical findings, reports, copied artifact bundles, ignored media intake, generated drafts, sensitive service-discovery evidence, progress ledger content, and archived spec-system records.
* Defined retained value, stable replacement owners, allowed Session 07 options, and blocked deletion conditions for each candidate group.

**Files Changed**:

* `.spec_system/PRD/phase_08/decommission_approval_matrix.md` - added candidate matrix and blocked deletion conditions.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T007 complete and updated progress summary.

***

### Task T006 - Map release risks

**Started**: 2026-05-31 00:39 **Completed**: 2026-05-31 00:46 **Duration**: 7 minutes

**Notes**:

* Added a release risk matrix for hosted identity, trusted erasure, production-hosted validation, Worker erasure, hosted storage/public replay, analytics, push/remote/tunnels, certification, media readiness, decommission, sensitive evidence output, and final release drift.
* Mapped each risk to owner sessions, required evidence, closeout criteria, and residual-risk wording.

**Files Changed**:

* `.spec_system/PRD/phase_08/phase08_release_risk_matrix.md` - added risk matrix and residual-risk rules.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T006 complete and updated progress summary.

***

### Task T005 - Route Phase 08 requirements

**Started**: 2026-05-31 00:31 **Completed**: 2026-05-31 00:39 **Duration**: 8 minutes

**Notes**:

* Added the Session 02-08 ownership map, P08-R001 through P08-R020 requirement routing, prerequisites, evidence outputs, and current claim states.
* Recorded explicit later deferrals for active hosted auth, hosted storage, analytics capture, Web Push, remote access, real executors, broad media promotion, and formal certification.

**Files Changed**:

* `.spec_system/PRD/phase_08/phase08_requirement_routing_matrix.md` - added session ownership, requirement routing, and explicit deferrals.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T005 complete and updated progress summary.

***

### Task T004 - Inventory release claim surfaces

**Started**: 2026-05-31 00:25 **Completed**: 2026-05-31 00:31 **Duration**: 6 minutes

**Notes**:

* Added the local-first release boundary and a claim gate inventory covering local-first operation, Worker federation, hosted identity/storage, analytics, public replay, push, remote access, trusted erasure, certification, production validation, media readiness, and legacy deletion.
* Preserved current allowed claims as narrow guardrail or local-only claims and routed stronger claims to later Phase 08 sessions.

**Files Changed**:

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md` - added release boundary and claim surface inventory.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T004 complete and updated progress summary.

***

### Task T003 - Create Phase 08 deliverable files

**Started**: 2026-05-31 00:22 **Completed**: 2026-05-31 00:25 **Duration**: 3 minutes

**Notes**:

* Created the four Session 01 deliverable artifacts with source review metadata, ownership purpose, and placeholder sections for the remaining foundation and implementation tasks.
* Kept deletion status candidate-only in the decommission artifact and made the baseline explicitly documentation-only.

**Files Changed**:

* `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md` - created release baseline scaffold.
* `.spec_system/PRD/phase_08/phase08_requirement_routing_matrix.md` - created routing matrix scaffold.
* `.spec_system/PRD/phase_08/phase08_release_risk_matrix.md` - created risk matrix scaffold.
* `.spec_system/PRD/phase_08/decommission_approval_matrix.md` - created decommission matrix scaffold.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded progress.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T003 complete and updated progress summary.

***

### Task T002 - Review release baseline inputs

**Started**: 2026-05-31 00:16 **Completed**: 2026-05-31 00:22 **Duration**: 6 minutes

**Notes**:

* Reviewed master PRD, UX PRD, Phase 08 PRD and session stubs, considerations, security posture, stable release/deployment/hosted/privacy/architecture/environment/legacy docs, and package README boundary notes.
* Identified source-backed baseline inputs: Phase 07 closed guardrails only, open findings for hosted identity/trusted erasure/production validation, Phase 08 session routing, local-first no-claim rules, media blocker posture, and candidate-only decommission constraints.
* Confirmed no app source changes are expected for this documentation-first session.

**Files Changed**:

* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - recorded source review.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T002 complete and updated progress summary.

***

### Task T001 - Verify analyzer state and prerequisites

**Started**: 2026-05-31 00:15 **Completed**: 2026-05-31 00:16 **Duration**: 1 minute

**Notes**:

* Ran the bundled `apex-spec` analyzer because no local `.spec_system/scripts` directory exists.
* Confirmed current session `phase08-session01-release-requirements-and-risk-baseline`, cross-cutting monorepo context, and prerequisite checker PASS.
* Verified Phase 07 closeout artifacts are archived and available, with Phase 08 residual risks carried forward for trusted erasure, hosted identity, production validation, certification, and decommission.

**Files Changed**:

* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md` - initialized implementation log and recorded environment verification.
* `.spec_system/specs/phase08-session01-release-requirements-and-risk-baseline/tasks.md` - marked T001 complete and updated progress summary.

***

## Task Log

### 2026-05-31 - Session Start

**Environment verified**:

* [x] Prerequisites confirmed
* [x] Tools available
* [x] Directory structure ready
* [x] Cross-cutting monorepo context confirmed

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase08-session01-release-requirements-and-risk-baseline/implementation-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
