TanStack / TanStack/intent

Provide a short workflow for authoring one validated skill

Open
#238 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
331
Forks
22
Avg merge
12h 17m
Merged PRs (30d)
51

Description

Problem

Scaffold routes maintainers through domain discovery, tree generation, and skill generation with intermediate artifacts and review stops. The existing lightweight branch still requires loading a large discovery file.

Evidence

The first three shipped meta-skills total 90,780 bytes. Domain discovery has a lightweight path, but scaffold still prescribes the three-stage sequence.

Sources: scaffold, domain discovery.

Verified against main at 206e987 (@tanstack/intent 0.3.8), Node v24.12.0 on macOS arm64. Tests used installed dependencies and synthetic local fixtures.

Acceptance criteria

  • Define a short path from one maintainer task to one validated SKILL.md.
  • Load optional planning schemas, tables, and extensive examples only when needed.
  • Keep the full-library authoring path available without forcing its artifacts onto the one-skill path.
  • Demonstrate the short path on one small package and record the context it requires.
  • Generated skills continue to satisfy existing validation and remain grounded in package source.

Scope and priority

Priority: Medium. Type: feature design.

Follow-up design, independent from repairing meta-skill validation. Do not delete advanced workflows or require a new artifact schema without a concrete need.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading packages/intent/src/commands/scaffold.ts and the domain-discovery SKILL.md, then compare the existing scaffold sequence with the lightweight discovery path. Demonstrate the proposed short path on one small package and record its required context. Done means the short path and full-library path both remain available, and generated skills pass existing validation while staying grounded in package source.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, typescript
Domain
cli, developer-experience, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.