oris-skills 2.2.1 → 2.2.3

package/skills/oris-flow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oris-flow
-description: The one Oris skill - read the intent, pick ONE route, apply it in the same chat. Use for /oris-flow and whenever the user wants to set up a repo for agents, start a project, understand or define behavior, write acceptance criteria, plan, implement, fix a bug, verify criteria, handle a spec change, run a work loop (fix until green, repeat until verified), review architecture, update task docs, or asks how Oris works.
+description: The one Oris skill - read the intent, pick ONE route, apply it in the same chat. Use for /oris-flow and whenever the user wants to set up a repo for agents, start a project, understand or define behavior, write acceptance criteria, plan, implement, fix a bug, verify criteria, handle a spec change, run a work loop (fix until green, repeat until verified), review architecture, update task docs, commit changes, open a pull request, or asks how Oris works.
 ---
 
 # Oris Flow — the router
@@ -32,6 +32,8 @@ Match the desired outcome to ONE route, then apply its reference:
 | loop | repeat work until verified — fix until green, step through a plan | `skills/oris-flow/references/loop.md` |
 | architecture | review architecture, find deepening/refactor opportunities | `skills/oris-flow/references/architecture.md` |
 | docs | update task docs after a change | `skills/oris-flow/references/docs.md` |
+| commit | commit changes with the Oris standard — map fresh, Conventional Commits, work item linked | `skills/oris-flow/references/commit.md` |
+| pr | open or update a pull request, English title/description linked to the work item | `skills/oris-flow/references/pr.md` |
 | help | how Oris works, install, update, troubleshooting | `skills/oris-flow/references/help.md` |
 
 ## Precedence (the calls that look ambiguous)
@@ -47,10 +49,14 @@ Match the desired outcome to ONE route, then apply its reference:
 5. CHECK once → verify. Repeat-until-verified → loop.
 6. EMPTY directory or from-scratch intent → new. Existing repo without
    `.oris-flow/manifest.json` → recommend setup first; respect the user's choice.
+7. COMMIT staged/working changes with the standard → commit. OPEN or update a pull request
+   → pr. Neither writes product code — they package and publish what implement/fix produced.
 
 ## Menu (low confidence)
 
-ASK "What do you want to do?" localized to `uiLanguage`, options:
+ASK "What do you want to do?" in the user's language. This menu exceeds every
+question tool's option cap — present it as a plain-text lettered list (the deliberate
+fallback in `references/conventions.md` `## Questions`), options:
 
 - Setup repository
 - New project from scratch
@@ -63,6 +69,8 @@ ASK "What do you want to do?" localized to `uiLanguage`, options:
 - Loop: repeat until verified
 - Architecture review
 - Update docs
+- Commit changes
+- Open a pull request
 - Help
 - Explain the options / Spiega le opzioni
 

package/skills/oris-flow/references/commit.md

@@ -0,0 +1,45 @@
+# Commit
+
+Turn staged or working changes into one clean commit — map fresh, message in English,
+work item linked. NEVER commit without showing the message and getting a yes.
+
+RULES: `references/conventions.md`. DevOps config: `references/devops.md`.
+
+## Before the commit
+
+1. FRESHEN the map: `npx oris-skills flow scan --repository-root <repo> --check`. Stale →
+   refresh ONLY the changed areas (`--area <section>`) and stage `.oris-flow/` with the change.
+2. READ the diff (`git status`, `git diff --staged`) to know what actually changed.
+3. RESOLVE the work item id from context — current branch, the active task doc, or the
+   DevOps provider's active items. Unsure → ASK once for the id; never invent one.
+
+## Compose (always English)
+
+- TYPE from Conventional Commits: `feat` | `fix` | `chore` | `docs` | `refactor` | `test`
+  | `perf` | `build` | `ci`. Pick from the diff, not the chat.
+- SUBJECT imperative, ≤72 chars, no trailing period. Optional `(scope)`.
+- BODY only when it adds signal: what and why, not how.
+- FOOTER: the work item via the provider `workItemSyntax` (default `#{id}`), on its own line.
+
+## Gate (never skipped)
+
+SHOW the full message + the files it will commit (code + refreshed map). ASK:
+commit | edit message | cancel. ON commit → `git commit`; NEVER `--no-verify`.
+
+## After
+
+- SUMMARIZE the commit (hash, subject, work item).
+- OFFER a pull request (`skills/oris-flow/references/pr.md`) or stop. NEVER auto-open one.
+
+## Never
+
+- Commit before the message and file list are shown and confirmed.
+- Write the message in any language but English.
+- Invent a work item id, or bypass hooks with `--no-verify`.
+- Refresh confirmed map sections, or scan-rewrite areas the diff did not touch.
+
+## Done when
+
+- [ ] Map checked, and refreshed in place only where the diff touched.
+- [ ] English Conventional message with the work item linked, confirmed at the gate.
+- [ ] Commit made without `--no-verify`; next step offered, not auto-run.

package/skills/oris-flow/references/help.md

@@ -16,7 +16,7 @@ details on request.
 | Loop status | `npx oris-skills loop chat --action status` / `npx oris-skills loop list` |
 | Skill missing after install | Reload the agent; check `~/.oris/oris-skills/` exists; re-run install with `--force`. |
 | Hook not firing | `npx oris-skills loop verify --temp` self-checks the runtime; `npx oris-skills loop bootstrap` re-arms repo hooks. |
-| Change language / test profiles | `/oris-flow` → Setup → language & profiles (settings live in `~/.oris/settings.json`). |
+| Change document language / chat verbosity | `/oris-flow` → Setup (settings live in `.oris-flow/settings.json`). |
 | Ultra-short answers | `/oris-flow` → Setup → set `responseStyle: caveman` — chat shrinks to maximum token density; documents stay complete. |
 | Edit a loop's behavior | Edit the files in `.oris-flow/loops/{slug}/prompts/` — the next pass obeys them. |
 

package/skills/oris-flow/references/pr.md

@@ -0,0 +1,44 @@
+# Pull Request
+
+Open or update a pull request whose title and description are English and linked to the
+work item. NEVER open or update a PR without showing it and getting a yes.
+
+RULES: `references/conventions.md`. DevOps config: `references/devops.md`.
+
+## Before
+
+1. ENSURE the branch is pushed and its commits follow the commit standard
+   (`skills/oris-flow/references/commit.md`); uncommitted work remains → route there first.
+2. READ the commit range to summarize the actual change, not the intent.
+3. RESOLVE the work item id (branch, task doc, or DevOps provider) — unsure → ASK once.
+
+## Compose (always English)
+
+- TITLE: one Conventional line, same grammar as a commit subject.
+- DESCRIPTION: a short **Summary** (what changed and why), a **Verification** line
+  (how it was proven), and the work item via the provider `workItemSyntax` (default `#{id}`).
+- KEEP secrets out — mask anything sensitive as `***` (`references/conventions.md` `## Gates`).
+
+## Gate (never skipped)
+
+SHOW the title + description + target branch. ASK: open PR | edit | cancel.
+ON open → create via the provider (Azure DevOps MCP `oris-devops`, or `gh` for GitHub)
+read from `references/devops.md`. Missing provider auth → say so; never guess credentials.
+
+## After
+
+- SUMMARIZE: PR link/number, target branch, work item.
+- RECOMMEND verify (`skills/oris-flow/references/verify.md`) when criteria exist.
+  NEVER merge automatically.
+
+## Never
+
+- Open or update a PR before the title and description are shown and confirmed.
+- Write the title or description in any language but English.
+- Invent a work item id, store credentials, or merge without being asked.
+
+## Done when
+
+- [ ] Branch pushed and commits follow the commit standard.
+- [ ] English title + description with the work item linked, confirmed at the gate.
+- [ ] PR opened/updated via the configured provider; merge never automatic.

package/skills/oris-flow/references/setup.md

@@ -18,7 +18,7 @@ refreshing. THEN ask ONE question with these options:
 - review stale sections
 - show summary (no writes)
 - recreate from scratch
-- language & profiles → Local Preferences below; touches only `~/.oris/settings.json`
+- preferences → Local Preferences below; touches only `.oris-flow/settings.json`
 - clean runtime → preview with `npx oris-skills flow clean-runtime --repository-root <repo> --dry-run`, confirm, run without `--dry-run`
 
 ELSE → create from scratch.
@@ -29,9 +29,13 @@ ELSE → create from scratch.
 2. SCAN: `npx oris-skills flow scan --repository-root <repo> --json` — deterministic
    baseline: `projectType`, stacks, commands (with confidence), sections, `truncated`
    flag. Scan output = draft evidence, not truth.
-3. IF `truncated: true` → say so; large monorepos may need per-area subagent scans.
-4. ADD parallel subagent scans (docs, frontend, backend/data, tests/build, local
-   skills/rules) only when the baseline leaves real gaps.
+3. IF `truncated: true` → say so, then per-area subagent scans are REQUIRED, not optional.
+4. FAN OUT parallel subagent scans (docs, frontend, backend/data, tests/build, local
+   skills/rules) by DEFAULT whenever the repo has more than one of those areas —
+   entering setup is the user's request to spawn (`references/conventions.md`
+   `## Subagents`). SKIP only when the repo is small enough that the baseline already
+   answers every §2 decision — say you skipped and why. No agent tool on the platform →
+   same scans inline, sequentially.
 
 ## 2. Present findings, decide one at a time
 
@@ -45,8 +49,6 @@ Then WALK decisions ONE per turn — short explainer first, recommended answer f
   project docs. Record in `setup.tasksRoot`.
 - **Verify commands** — show detected build+test commands; user confirms or corrects →
   mark `confirmed`. They feed implement, verify, and loop VERIFIER; unconfirmed = a guess.
-- **Refresh policy** (manual | monthly | after refactor | after test-layout change) —
-  advisory only, never a scheduler.
 - **Version control for `.oris-flow/`** — commit (team default) or gitignore. Task docs
   follow the same choice.
 
@@ -78,10 +80,10 @@ ON explicit confirmation per file → scaffold the missing ones minimal.
 
 ## Local Preferences
 
-1. READ `~/.oris/settings.json` (defaults in `references/settings.md`).
-2. ASK what to change: uiLanguage | artifactLanguage | responseStyle (standard |
-   caveman — maximum token density in chat) | default test profile | profiles.
-3. SHOW masked summary (passwords `***`), CONFIRM, write ONLY the settings file.
+1. READ `.oris-flow/settings.json` (defaults in `references/settings.md`).
+2. ASK what to change: artifactLanguage (document language, default `en`) | responseStyle
+   (standard | caveman — maximum token density in chat).
+3. SHOW summary, CONFIRM, write ONLY the settings file.
 
 ## Never