@aiworkforce/create-profession

Create an AI Workforce Professional Package from the Canonical Profession Project.

npx @aiworkforce/create-profession inventory-manager

AI advises. The professional decides.

This package is a thin scaffolder. It materializes a working starter Professional Package that depends only on the public SDK @aiworkforce/sdk.

Prerequisites

• Node.js >=20 (see engines in this package)
• npm

Quick Start

npx @aiworkforce/create-profession inventory-manager
cd inventory-manager
npm test
npm run build
npm run demo

What the generated project demonstrates

The starter profession:

• observes a professional situation;
• applies judgment through the professional thinking cycle;
• may propose durable Professional Work when the observed situation warrants it;
• does not authorize that Work;
• leaves authority with the human.

Proposed != Authorized
Authorization != Execution

The sample judgment is profession-neutral. Replace the sample escalation predicate with the real judgment of your profession. Do not treat memory or reflection wording as escalation evidence.

What this journey completes

After create -> test -> build -> demo (and optional npm pack):

• you have a local Professional Package project;
• you can validate advisory behavior, including selective proposals.

You have not:

• published the package to npm (unless you do so separately);
• installed it into a Host;
• Direct Loaded or registered it in a platform registry;
• authorized or rejected Work;
• executed Work.

Host boundary

@aiworkforce/sdk and this scaffolder do not provide:

• Engine, loader, registry, installer;
• Work store;
• authorize / reject APIs;
• a public Host npm package.

There is no @aiworkforce/host (or equivalent) on the public registry today. Host composition is application-owned. See @aiworkforce/sdk ADOPTION.md for the honest next integration step.

Direct Load is not installation. Proposal is not authorization. Authorization is not execution.

Canonical source

The scaffolder distributes the Canonical Profession Project. That project remains the single source of truth for the starter experience. This package does not invent a second template.

Documentation

• This README - public create path and Host boundary
• @aiworkforce/sdk README and ADOPTION.md - contracts and adoption boundary

Repository guides require AI Workforce repository access. Anonymous GitHub documentation URLs may not resolve.

Troubleshooting

| Situation | What to do | |-----------|------------| | Target directory already exists and is not empty | Choose a new slug, or remove/rename the directory | | Dependency installation fails after project creation | cd <project> then npm install | | Unsupported or outdated Node.js | Upgrade to Node.js 20 or newer | | npm registry or network failure | Retry when the network is available; confirm you can reach registry.npmjs.org |

License

MIT