Skip to content

About

An Eliware workspace template for indexed role guidance, ownership, communication, and recovery.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

eliware.org

@eliware/workspace-template License CI

An Eliware workspace template for indexed role guidance, ownership, communication, and recovery.

Table of Contents

Features

This template organizes role guidance, local procedures, decisions, and recovery steps. Each derived workspace defines its role owners and decision boundaries.

Requirements

Use Node.js 26 or later and npm 12 or later for repository validation.

Setup

Create a repository from this template. Set its name, description, URLs, keywords, role owners, and decision boundaries. Replace the sample guidance and procedures with approved content for the derived workspace. Keep implementation and shared policy in their owning repositories. Run npm ci from the repository root.

Usage

Read the workspace guide before you adapt the template. Use the runbook index to find the sample procedures. Read the release notes for changes in each template version.

Development

Read AGENTS.md before you change files. Use the specifications index to find structured requirements.

Testing

Run npm test before handoff. It runs aggregate repository checks through eliware-test.

Troubleshooting

If npm ci fails, use Node.js 26 or later and npm 12 or later. If npm test fails, read the reported file and rule. Fix the source document. Run npm test again.

Security

Keep credentials, secrets, private data, and runtime state out of Git. Use an approved secret store for each secret value. The template repository is public. package.json sets private to true, so npm publication is disabled. The template has no container publication workflow. Set source visibility and publication options for each derived repository.

Runbooks

Store each local procedure in a separate .yaml file under runbooks/. List each procedure in the runbook index. Use the workspace guide for the shared schema and adaptation steps.

The sample runbooks are incomplete examples. Replace each placeholder in a sample runbook. Ask the owner to confirm the completed procedure before use.

Communication

Use your organization's approved communication channel for cross-role release decisions and company-wide procedures. Use GitHub Issues to name work owners and record status, blockers, and required actions.

Recovery

Keep workspace-specific recovery steps in local runbooks. Follow the approved recovery procedure for the affected role. Follow the cross-role recovery procedure that your organization approves.

Support

For help, questions, or to chat with the author and community, visit:

Discordeliware.org

eliware.org on Discord

Links

License

MIT © Eliware

About

An Eliware workspace template for indexed role guidance, ownership, communication, and recovery.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors