OpenTangl

Configure a self-driving development loop for any JavaScript/TypeScript project. This skill detects your project setup, generates configuration files, and prepares OpenTangl to run autonomously.

Follow these steps in order. Complete each step fully before moving to the next. Wait for user confirmation at every gate before proceeding. Do not skip steps or combine them — the user needs to complete actions on their end between steps.

Prerequisites

The user must have OpenTangl cloned and installed before using this skill. If they haven't, provide these commands for them to run:

git clone https://github.com/8co/opentangl.git
cd opentangl
npm install

Do not run these commands on the user's behalf. Wait for confirmation that OpenTangl is installed.

Once confirmed, verify the required tools are present. Run each check and report the results:

• Node.js ≥ 18 — run node --version and show the output
• git — run git --version and show the output
• GitHub CLI — run gh auth status and show the output (needed for PR creation and merging)

Report all results to the user. If anything is missing, tell them exactly how to install it and stop until resolved.

Step 1 — Determine the Target Project

Ask the user:

Are you improving (a) an existing project, or (b) starting from scratch?

Path A: Existing Project

1. Ask: "Where is your project?" Accept a path. If they say "this directory," use cwd.
2. Tell the user you'll read config files in their project directory to detect the setup. Only inspect files in the directory the user provided — do not scan outside it. Check:
   • Type: tsconfig.json → TypeScript, vite.config.ts → Vite, next.config.* → Next.js, serverless.yml → Serverless
   • Package manager: package-lock.json → npm, yarn.lock → yarn, pnpm-lock.yaml → pnpm
   • Build/test commands: Read package.json scripts for build, test, lint, typecheck
   • Source dirs: Default to src/ if it exists
   • Target branch: Check git symbolic-ref refs/remotes/origin/HEAD or look for main vs master
3. Show everything you detected and confirm with the user before proceeding.
4. Ask: "Are there other repos that are part of this same product?" If yes, repeat detection for each.

Path B: New Project

Tell the user to scaffold and initialize their project before continuing. Suggest the appropriate tool based on what they want to build:

• React + Vite: npm create vite@latest {name} -- --template react-ts
• Next.js: npx create-next-app@latest {name} --typescript
• Express: create package.json + src/index.ts manually

They should also initialize git and create a GitHub repo:

cd {name}
git init && git add . && git commit -m "Initial scaffold"
gh repo create {name} --public --source . --push

Do not run these commands on the user's behalf. Once they confirm the project exists with a GitHub remote, continue.