01 · Choose a workflow by the result you need
Headless reading route: One actual recorded Work → operating prerequisites and commands. The reader does not execute Work.
Start with one outcome. A Work operator, an asset user and an administrator may use the same desktop, but need different inputs and permissions. Follow the linked procedure until its completion check is satisfied or its failure branch names the missing prerequisite.
| I need to… | Use this surface | Keep this result |
|---|---|---|
| Prepare and follow one Work | PackrGUI | Original request, returned Work ID and the same Work’s report |
| Operate without a desktop | Headless | Endpoint identity, command result and returned Work ID |
| Find and inspect a reusable asset | Packtory library | Exact Pack identity, revision, scope and availability |
| Inspect or change appliance administration | Packr Administrative Console / VibePackr Admin | Bound installation, current revision and refreshed action result |
| Review asset governance and contribution | Packtory Administration | Bound domain, exact asset revision or Contribution evidence/export reference |
02 · Prepare a small operator exercise
Role: an operator with access to the supplied installation; a separate administrator joins only if an administrative prerequisite fails. The example goal is “create audit artifact”. It is non-confidential teaching text, not a business workload.
- Obtain the version-specific delivery instructions, installed client/command, intended endpoint and your product identity from the delivery contact. Keep credential values out of the worksheet.
- Confirm which actions your role permits. Reading status, submitting Work and changing services are separate permissions.
- Record the installation and current time. Decide who will review the result.
- Read the connection/readiness procedure for your chosen client. Continue only when the required connection and operation are available.
- Choose one submission route below. GUI and CLI are alternatives for the exercise; using both would request two operations.
Ready to begin: you can name the target, operator, allowed task and result reviewer. If first-administrator access or a delivery item is missing, send that exact prerequisite to the delivery contact; the r232 first-customer path remains pending.
Blank operator worksheet; no observed product outcome is supplied.
One operating task — documentation worksheet
Goal: [one intended outcome]
Surface / version / target: [confirmed scope]
Mode: [read-only / authorized change]
Prerequisites: [access, readiness and supported inputs]
Before: [state and revision, where reported]
Action: [one supported command or UI operation]
Returned: [status, reason and operation/work reference]
After: [fresh read-only observation]
Expected versus observed: [match / mismatch / uncertain]
Validation and result review: [specific observation]
Next step and owner: [bounded next action]
Do not mark success from process exit, a visible menu, an accepted request or a timeout alone.
03 · Follow one Work from input to reviewed result
Headless reading route: One actual recorded Work → operating prerequisites and commands. The reader does not execute Work.
| Stage | GUI route | Headless route | Check before continuing |
|---|---|---|---|
| 1. Read the target | Read Control Plane and workspace | Read health and readiness | Intended local installation and available required operation |
| 2. Prepare input | Request → Prepare Work | Read the registered-operation recipe and choose a unique approved key | Non-confidential request; no attachments or selected Pack for this local audit operation |
| 3. Submit once | Review the prepared summary, then use the supported Submit action when permitted | Run the documented command only when authorized; it prepares and executes in one invocation | Retain the actual returned Work ID; a local draft is not a submitted Work |
| 4. Read the same Work | Select the Work and its report | Show the returned Work ID | Work identity, execution, validation, receipt and remaining human decision |
| 5. Resolve uncertainty | Read-only reconciliation | Read-only reconciliation | Do not submit another request to resolve a timeout |
Completion: the actual result belongs to the original Work, its required checks are satisfied, and any required human acceptance is recorded. “Prepared”, a zero exit code, a visible report or a receipt alone does not satisfy every task condition.
If you change clients to read the result, confirm the same installation, permitted principal and returned Work ID first. A matching title is insufficient. The documentation does not establish that every GUI/CLI delivery pair supports cross-client access.
04 · Follow an asset from discovery to a permitted next step
- Use Packtory library search to locate the exact asset and revision.
- Read scope, availability, provenance and dependencies. Ask the asset owner about missing data; do not infer that an empty field establishes eligibility.
- If a configured catalog provides a downloadable asset, follow the local-availability recipe and inspect each result.
- If the client exposes a supported Pack-consuming Work route, use the draft-selection recipe. The documented local audit composer currently rejects selected Packs.
- For governance questions, pass the exact asset revision to Packtory Administration. Keep Work references separate from asset references.
Completion: record which result you reached—asset inspected, local availability confirmed, draft preference set, or a separately supported Work completed. Each is a different finish line.
05 · Use administration to resolve a named prerequisite
Administration starts from a named problem, such as a stopped service or a missing domain binding. It is not an automatic next step after every Work.
| Task | Procedure | Required completion evidence |
|---|---|---|
| Inspect appliance identity and authority | Connect → Refresh → compare identity | The intended installation and effective role |
| Perform an approved service/configuration change | Service / Configuration | Before revision, exact permitted action, returned result and refreshed state |
| Inspect asset/domain readiness | Binding Context | Exact bound context or a named missing binding handed to its owner |
| Review Contribution | Preview → Export and verify | Matching user/scope/period/evidence set and exact export verification result |
A customer without the supported initial administrator handoff cannot use a CLI example or a visible Administration menu to create that authority. Follow the delivery dependency in administration prerequisites.
06 · Finish with an outcome or an actionable handoff
Keep the smallest record that lets the next person reproduce your interpretation. Include the surface/version, intended target, exact failed step, sanitized reason, Work or asset reference when available, before/after observation and whether a change may already have occurred. Keep secrets and confidential task contents out of support messages.
| Missing condition | Recipient | Concrete request |
|---|---|---|
| Client, command or first-administrator delivery | Delivery contact | Provide the supported item/procedure for this version and installation |
| Unavailable service or connection | Installation operator | Reconcile endpoint, service readiness and original operation outcome |
| Denied product action | Product administrator | Check the required permission for this identity and exact action |
| Asset scope/revision or binding unclear | Asset/domain owner | Confirm the exact approved asset revision and bound context |
| Unexpected Work/report result | Support contact and authorized reviewer | Reconcile the original Work and its missing result field |
Documentation worksheet. Replace bracketed prompts with sanitized facts; not a product request or configuration file.
VibePackr support report — documentation worksheet
Surface: [Headless / PackrGUI / VibePackr Admin / Packtory Admin]
Product / client version: [reported version, or unknown]
Time and time zone: [observed time]
Target: [local or remote; use an approved non-secret reference]
Task and expected result: [one sentence]
Last successful step: [step]
Failed step: [exact command shape or screen action; remove private values]
Observed status / reason: [sanitized exact values]
Was a change submitted? [yes / no / uncertain]
Read-only reconciliation after failure: [observed state or not yet checked]
Customer impact: [what is unavailable]
Actions already taken: [facts, no speculation]
Question / requested next step: [one bounded request]
Exclude passwords, tokens, private keys, credential paths, raw logs and customer payloads.
Send extra identifiers or diagnostic packages only through the agreed private channel.
Handoff complete: an owner and a next check are recorded. Keep the original operating task open until its success condition is actually met.
07 · What is documented and what was observed
Choose a workspace, then follow the menu for your task. Each route explains its purpose, what to bring, the controls to use, how to read the result and where to go next. The Business example follows one real audit Work from request to final report. Engineering and Operations also document every menu in the inspected R234 client, including the actual empty and unavailable states.
| Workspace | Choose a menu |
|---|---|
| Business | Home · Request · My Work · Review · Approvals · Results · Projects |
| Engineering · IDE | Intent · Repository · Change · Build · Validate · Artifacts · Review · Closure |
| Engineering · tools | Runtime · Audit · Reports · Memory · Packs |
| Operations | Overview · Runtime · Environments · Approvals · Policies · Audit |
These are real local candidate screens, not a demonstration that every product operation succeeded. The retained audit Work did not edit source, run a repository build, call an AI provider or receive human acceptance. No new Work was submitted during the additional menu capture. The matching customer release, populated engineering workflows and acceptance remain separate validation tasks.
| Surface | Available observation | Remaining scope and evidence limits |
|---|---|---|
| PackrGUI | One connected local Work, three workspace views and canonical PDF/JSON | Customer release delivery and human acceptance; Runtime and Audit Registry limitations remain |
| Headless | Actual local R234 recorded run: input rejection, reconciliation and correction; one Work, same-Work readback, validation PASSED and matching report hashes | Customer installation, overall readiness and product acceptance are separate. The selected documentation format is a record reader; it does not provide a live terminal session. |
| Packtory library | Unavailable projection | Configured exact asset → inspect/download/selection result |
| Packr Admin | Source-backed procedures | Supported administrator delivery → connected session → authorized action/readback |
| Packtory Admin | Actual unbound Overview | Bound domain → asset/Contribution task → verified result |
The Headless reader and guide can be reviewed together now. Customer reproduction, matched release delivery and Google submission remain separate items.