Skip to content

Spec MVP: project harness audit/design skill suite #38

@sungjunlee

Description

@sungjunlee

Parent: #35

Problem

Maintainers need a practical way to turn a real repo into a better agent workspace without dumping everything into root CLAUDE.md / AGENTS.md.

Proposed MVP

Draft a small skill-suite spec for project harness work. Candidate surfaces:

  • craft-harness-audit: inspect an existing repo harness and report what belongs in root context, local context, skills, hooks/scripts, or external tools
  • craft-harness-spec: design the target harness shape from the audit plus project constraints

Names are placeholders. The design may choose one skill first if two triggers are premature.

Acceptance Criteria

  • The MVP uses progressive disclosure and keeps the core spine short.
  • It includes 3-5 eval prompts such as monorepo, legacy repo, small library, multi-agent relay repo, and no-existing-harness repo.
  • It defines missing-context behavior: inspect local files first, ask only when authority or project goal cannot be inferred safely.
  • It avoids provider-specific implementation in the core spine.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: docsDocumentation and README workarea: opsOperational safety and eval workflowarea: skillsSkill authoring assetscraft-reviewWork derived from CraftKit skill reviewpriority: mediumMedium prioritytype: taskConcrete implementation task

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions