workspace-setup
/workspace-setup
Create or deliberately adopt a multi-repository Docflow WORKSPACE with a registry and portable memory. Use for workspace-setup or establishing a workspace home. NOT for bootstrapping a member repository, orientation, planning an outcome or executing assignments.
- Author
- evolvehq ↗
- Repository
- docflow ↗
- Licence
- MIT
- Last repository change
- 22.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 2
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
Create or deliberately adopt a multi-repository Docflow WORKSPACE with a registry and portable memory. Use for workspace-setup or establishing a workspace home. NOT for bootstrapping a member repository, orientation, planning an outcome or executing assignments.
Original author description
Create or deliberately adopt a multi-repository Docflow WORKSPACE with a registry and portable memory. Use for workspace-setup or establishing a workspace home. NOT for bootstrapping a member repository, orientation, planning an outcome or executing assignments.
How it works
- Operating contract
- Resolve inputs and current authority
- Procedure
- Recovery and unknown outcomes
- Closing report
SKILL.md preview
---
name: workspace-setup
description: Create or deliberately adopt a multi-repository Docflow WORKSPACE with a registry and portable memory. Use for workspace-setup or establishing a workspace home. NOT for bootstrapping a member repository, orientation, planning an outcome or executing assignments.
---
# workspace-setup
Establish the operator-selected canonical workspace home.
## Operating contract
**Inputs:** selected destination, new/adopt choice, purpose, canonical home, member identities/paths, owner, native host and write scope.
**Effects:** create or merge only the agreed workspace files and ignores; initialise its Git history only when authorised. Cloning/registering members is a separate named effect. Never implicitly convert a parent container.
**Native claims / dependencies / resources:** confirm ownership of the destination and any shared configuration; require explicit member access before registration validation. No member execution is assigned.
**Stopping point:** a validated, inspectable workspace with a dated overview, or a concrete missing-input/asset/ownership blocker.
**Receipt:** paths created/merged, preserved files, package revision, actual validation command/output/exit, unresolved members, host availability and next action. Do not create a fictitious run for setup without a work/grant.
## Resolve inputs and current authority
Reuse applicable choices already supplied, including host, actor, paths,
scope, depth and stopping point. Summarise the resolved choices; ask only
for a material missing or conflicting choice. A recorded preference alone
does not supply authority. Selection sets priority; accepted agreement,
role, profile, registry membership and a copied brief grant no execution.
Locate the installed sibling bootstrap skill (resolve symlinks first).
Its `templates/workspace-assets.json` lists the packaged asset locations:
`../../workspace` in a plugin or `../../docflow-workspace` in a detached
copy, relative to bootstrap. An explicit asset root is valid. Read that
root's `CONTRACT.md`, `schema.json` and `README.md`; all templates are
in bootstrap's `templates/`. If missing, report the exact missing asset
and stop dependent writes. Never assume a source checkout or install/fetch
dependencies implicitly. The external validator requires Node.js 22+.
For adoption, read the existing workspace entry point, registry, conventions
and canonical records. For a new home, inspect only files already present;
missing initial workspace files are expected and will be created from the
authorised setup choices. Read declared native member instructions when
members are supplied and member access is authorised. Resolve canonical
home/full UUID and contained paths, including symlinks; a missing member
stays registered with diagnostics. Search only authorised roots. Copied
context and search indexes are discovery aids: read current authority,
claims and critical constraints directly.
Before each dependent action, recheck the actual operator mandate for actor,
scope, effects, conditions and stopping point. Initial authorised setup,
scoped reads and authorised canonical planning use that mandate; they do
not require or justify inventing a work record or execution grant.
For grant-bound native execution, additionally recheck the current grant:
actor, scope revision, delivery, action/effects, conditions, start, expiry,
revocation/suspension, exact grant revision and stopping point. Reuse an
existing compatible grant; request only missing or changed authority.
Check native ownership, dependencies and shared resources separately.
Reference-only members permit only scoped non-mutating actions. A denied
tool/action stops that action across alternate tools, routes and delegates.
Contact loss is not worker exit and never permits reassignment.
Validate with `node <assets>/validate.mjs <workspace> --at <current-UTC>`;
supply the actual UTC time and retain complete output/exit. Validation checks
record consistency, not permission, live ownership or proof of execution.
Unknown, stale, skipped, missing and failed evidence remain distinct.
## Procedure
1. Inspect the selected destination and existing Git/ignore/instruction files.
For adoption, describe the exact preservation/merge plan using supplied
approval. Never replace existing content or initialise the surrounding
container. Recheck permission for each write.
2. Follow the asset README's assembly mapping: workspace README and AGENTS
at the root, registry/conventions/index under `.docflow_workspace/`.
Create the five record folders plus agents, profiles, integrations and
ignored local state. Ignore `/repos/` and `/.docflow_workspace/local/`
without dropping existing ignore rules. Members retain independent Git
histories, never submodules or copied governance.
3. Replace synthetic home/owner/paths with actual choices. Start with empty
records and `{"schema":1,"sources":[]}`; register only supplied member
identities, aliases, paths, role and native instructions. No remote fetch
or clone follows merely from registry membership. A member may be
remote-only: `role: reference`, a `remote` URL and no path or instructions;
its references are identity-only and its actions stay non-mutating.
Register a derived documentation set in `sources.yaml` `documents` by
external locator and digest; never vendor the document into the workspace.
4. Copy the five workspace record forms to the adopter's
`.docflow_workspace/templates/`, outside canonical record folders.
Offer the four `workspace-role-*.md` starter forms, profile examples and
source catalogue from bootstrap. The separate `workspace-run-import.md`
form backfills imported execution history read-only; it carries no grant
and never satisfies a dispatch check. Adopt only chosen entries, pin actual
installed revisions and owner, and preserve existing configuration.
Empty recommendations and no extra role/tool are valid choices.
5. Read `<assets>/guides/README.md` and the chosen native guide.
Record availability separately from configuration and authority. Default
search is ordinary files; optional retrieval remains experimental.
6. Validate and inspect the resulting diff. Derive INDEX from canonical
records, with observation time and unresolved diagnostics. For a new empty
home it lists no fabricated decisions, grants, runs or completion.
Commit/publish only under the workspace's native Git rules and existing
authority. Return the receipt; the next activity is workspace-status or
workspace-scope, not automatic dispatch.
## Recovery and unknown outcomes
Resume by inspecting actual files and Git state against the intended mapping;
do not rerun setup blindly. Preserve partial files and list the next missing
step. Missing access or a denied write blocks that effect, while safe reads
can explain the state. A validation timeout is unknown, never a completed
setup. Upgrade and removal use the asset README and preserve canonical
memory, independent members and native rules.
<!-- docflow:closing-report -->
## Closing report
End every run, including blocked, failed and stopped runs, with a section
headed exactly **Status at a glance**, containing these three labels:
- **This run:** only actions actually attempted and their outcomes; quote each verify gate's exact output and exit code, including timeouts or interruptions.
- **Overall:** implemented, partially verified, verified, blocked, failed or unknown. A passing sub-step is not an overall pass; incomplete or missing evidence never becomes success.
- **Yet to do:** every remaining action, unresolved finding, verification, cleanup or required input. Write None only when the whole task is verifiably complete; never omit work because a budget ended.
Routine progress messages need no block. Keep final results brief and
distinguish work prepared on a PR from work confirmed shipped.
<!-- /docflow:closing-report -->
Files in this package (2)
- SKILL.md 8 KB
- agents/openai.yaml 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · evolvehq/docflow | 100 | MIT |
| mikeleg/skills | 100 | MIT |
| madappgang/magus | 100 | MIT |
| danielrosehill/claude-image-production-plugin | 100 | MIT |
| alex20-create/workspace-setup-skill | 100 | MIT |
| seziCZ/daybook | 100 | Apache-2.0 |
| byenzyme/margins | 96 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 9496408f2732 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 91workspace-membership
Use when a package directory and the workspace's member list may disagree. - 100nxs-workspace-status
Print the workspace status read-out — the hub, each declared member, and each member's checkout state — resolved from the current checkout. Use to verify a new or changed multi-repo workspace before a downstream stage depends on it, or to confirm a repo is in single-repo mode. - 96workspace-standards
Use when setting up or managing multi-repo workspaces - 90bootstrapping-repository-memory
Use when a repository or subsystem lacks usable canonical memory and needs an initial memory baseline - 82gsd-new-workspace
Use when you need an isolated copy of one or more repos with its own .planning/, or want to work on several repos in parallel. Creates worktrees or clones plus WORKSPACE.md; then run /gsd-new-project inside. - 100jj-workspace
Create or delete a jj (Jujutsu) workspace — a second checkout of this repo, sharing one repository. Use when you need to work on something side by side with the current checkout, for instance to leave a long build or test run undisturbed, and to clean the workspace up afterwards.