mcpField
O
orient

orient

github.com/camachoAgent workflows646 installs
Repository

About orient

orient is an agent skill that gathers task context, classifies work, checks project decisions and recent memory, then prepares a brief and routing recommendation. It is intended for repository task kickoff.

Key features

  1. 01Fetches GitHub issue details when available
  2. 02Classifies task and selects a branch prefix
  3. 03Scans ADRs for relevant decisions
  4. 04Checks for interrupted work and recent memory
  5. 05Creates a task brief and routing recommendation

Use cases

  1. 01Starting work from a GitHub issue
  2. 02Preparing a branch plan from a task description
  3. 03Resuming work using saved branch context

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/camacho/ai-skills --skill orient

After installing, type/orientin Claude Code to confirm it loaded.

Details

From the project README

Phase gate: EXPLORE checkpoint. This skill MUST complete all steps before proceeding to Isolate.

Steps

  1. Fetch issue context (if issue number provided):

    gh issue view <number> --json title,body,labels,assignees

    If no issue number provided, ask the user to describe the task. If gh is not available (remote session without GH_TOKEN), skip issue fetch and proceed with manual description.

  2. Auto-detect task type from labels or description:

    Label / keywordTypeBranch prefix
    bug, error, crash, broken, fixBugfixfix/
    enhancement, feature, add, want, should, newFeaturefeat/
    chore, config, deps, ci, toolingChorechore/
    docs, documentation, readmeDocsdocs/
    DefaultFeaturefeat/

  3. Scan for relevant ADRs:

    ls "$(git rev-parse --show-toplevel)/ai-workspace/decisions/"*.md 2>/dev/null | head -20

    Check ADR titles/filenames for keywords matching the issue title/body. If matches found, read the relevant ADR and surface it. If ADR scan finds contradictions, surface explicitly: "This task may conflict with ADR-NNN"

  4. Check for interrupted work: If "$(git rev-parse --show-toplevel)/.branch-context.md" exists, read it and include in the brief (resuming work).

  5. Read recent memory:

    tail -20 "$(git rev-parse --show-toplevel)/ai-workspace/MEMORY.md" 2>/dev/null

  6. Present brief:

    ## Orient Brief
**Task**: [title or description]
**Type**: [bugfix/feature/chore/docs] → branch prefix: [fix/feat/chore/docs]/
**Suggested branch**: [prefix]/[kebab-case-name]
**Relevant ADRs**: [list or "none found"]
**Resuming?**: [yes — from .branch-context.md / no]
**Files likely affected**: [educated guess from issue description + ADR context]

  7. Auto-route using the one-sentence rule:

    • Can the entire diff for this task be described in ONE sentence? → Direct to Isolate (skip Design/Review)
    • Otherwise → Plan first (proceed to Design after Isolate)

    Present the routing decision. The agent auto-decides — no human input required. If human is present, they can override.

Edge Cases

  • No issue number + no user description → ask for a description
  • gh not available → skip issue fetch, proceed with manual description
  • No ADRs directory → skip ADR scan

Comments

Markdown supported