Repository navigation
docs(onboarding): document capabilities, triggers, and Hook trust for… - #2047
Merged
Merged
Conversation
Lkx-JY
requested review from
Alanxtl,
PsiACE and
zhanghuidinah
as code owners
October 17, 2026 13:46
hireview001
reviewed
Oct 18, 2026
hireview001
left a comment
Collaborator
There was a problem hiding this comment.
- Resolve merge conflicts with the target branch.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Which issue or RFC does this PR close?
Closes #1713.
Builds on #2003 (merged).
Rationale for this change
#2003 improved the English, Chinese, and Japanese READMEs: it clarified what PowerContext is, explained Scope and the main artifacts, added Dashboard examples with synthetic records, and made benchmark results readable as text. It also documented boundaries such as immutable Revisions, review, and explicit Skill export. That PR explicitly left the installation-path Skills guidance in #1713 unresolved.
This PR addresses the remaining onboarding gaps. Users following README and Quick Start need to know which capabilities they can use, how to request them, which require Server models or policies, and how to recognize successful results. They also need the first-session Hook trust step before checking automatic capture and recall. MCP connectivity alone does not establish that either has run.
What changes are included in this PR?
scripts/guidance_templates/base/references/work-handoff.md.j2and the generated host Skills; it does not change runtime authorization.forgottenlifecycle request and links legacymemorycompatibility to the migration guide. Clarify that downloading a Skill package alone does not establish installation, and update links to the revised Quick Start section.Are there any user-facing changes?
Yes. The documentation now guides users through first-session Hook trust and mode-appropriate checks, then into supported workflows. No runtime APIs, persistence formats, or dependencies change.
How was this change tested?
UV_CACHE_DIR=/tmp/pc-1713-uv-cache uv run --no-sync pytest tests/test_release_version.py tests/test_full_capability_docs.py -q— 14 passed.UV_CACHE_DIR=/tmp/pc-1713-uv-cache uv run --no-sync python scripts/release_version.py --check— passed.make docs-test— passed: website lint, 13 website tests, 2 link-validation tests, production build, and verification of 940 public pages and their internal links.git diff --check— passed.Capability names and entry points were checked against the MCP catalog, Artifact/Tag types, Atomic Memory state/lifecycle contracts, the base Handoff guidance template, and generated Codex/Claude Code/WorkBuddy Skills. Native Codex trust prompts, host Handoff transfers, live model extraction, and host Skill discovery were not executed; passing documentation checks does not establish those host workflows.
AI usage statement
Implemented and verified with OpenAI Codex. AI assistance was used for source tracing, implementation, regression-test design, documentation, and validation; the resulting changes were reviewed locally.