Skip to content

Add a first-party agent guide installer #415

Description

@Teakowa

Goal

Provide a small first-party Wright command that installs the canonical agent-facing Wright capability guide into a coding-agent project, so users can enable the Wright workflow without Node tooling or manually reconstructing agent instructions.

Context

Wright owns the executable agent/tooling surface: diagnostics, lint/analyze/inspect, structured query/service contracts, validated edits, provider integration, and future agent transports. The installable guidance should teach a general coding agent how to discover and use those capabilities; it should not contain a second Workshop semantic implementation or a parallel tool suite.

The public wrightkit/skills repository is the distribution home for this optional guidance layer.

Scope

  • Add an agent CLI surface with a one-command install path for the canonical Wright agent guide.
  • Install the guide project-locally by default; allow an explicit destination or supported-agent target when needed.
  • Keep the installed content small and capability-oriented:
    • discover Wright capabilities instead of assuming a fixed command inventory;
    • prefer Wright structured diagnostics/queries/validated edits over textual guessing;
    • use owning language engines through Wright rather than recreating language semantics;
    • re-check/validate after edits;
    • surface unsupported capabilities explicitly instead of silently falling back.
  • Keep manual installation possible from wrightkit/skills.
  • Make repeated installation/update safe and deterministic.
  • Document removal/update behavior.

Non-goals

  • A generic agent framework, planner, model integration, or prompt manager.
  • Reimplementing Agent Skills package management.
  • Bundling Workshop reference corpora or large static knowledge prompts.
  • Shipping separate JS/Python helper tools for symbol search, compilation, or analysis.
  • Adding language semantics outside their owning repositories.

Acceptance criteria

  • A user with Wright installed can add the current canonical Wright agent guide to a project with one Wright command.
  • The installed guide contains no executable semantic/tool implementation and does not require npm.
  • The guide directs agents to runtime capability discovery and Wright-owned structured interfaces rather than hardcoding a second semantic contract.
  • Re-running the command does not create duplicate conflicting copies.
  • Manual installation of the same guidance from wrightkit/skills remains documented and possible.
  • Existing Wright behavior is unchanged when the agent guide is not installed.

Dependencies / ownership

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions