format: canned-prompt/v0.2
id: helix/repo-orient
name: Repo Orientation
version: 0.1.0
summary: >
  Establish what a repository is for, what work is pending, what completing it
  would be worth, and what it would cost — then recommend what to do next.
type: template
template: prompt.md

dependencies:
  prompts:
  - id: helix/custodian-conventions
    version: ">= 0.1.0"
    requirement: required

inputs:
- name: conventions
  type: content
  required: false
  description: Operating conventions, composed from helix/custodian-conventions.
  default:
    include: helix/custodian-conventions

parameters:
  depth:
    type: enum
    values: [recommendation, full]
    default: full
    description: >
      `recommendation` answers only "what should we do now" with its reasoning.
      `full` gives the whole orientation before recommending.

output:
  format: markdown
  description: >
    An orientation covering purpose, pending work, value and effort, ending in
    a single recommended next action with its reasoning.

license: MIT
tags: [orientation, planning, custodian]
provenance:
  author: Bernd Worsch
  source: personal prompt collection, contributed 2026-09-06