refactor-plan
Skill7.6k starsChanged 5 months agoMITView on GitHub
Judge whether a system is fragile or just fast-moving, and write a ticket-ready refactor plan for one root problem, with measured evidence and a stable fingerprint. Use after system history (or a bug trace) points at a systemic problem worth fixing at the root.
Files
Refactor plan
Judge first
references/rubric.md separates fragile from fast-moving from coupled, and
sets confidence. The counts from system-history are leads. A plan needs
a named repeated mechanism, taken from diffs you read.
Scaffold
pnpm exec tsx .agents/skills/refactor-plan/scripts/new-plan.ts --run <id> \
--slug <kebab> --title "<imperative line>" --systems a,b \
--area <Framework|Slides|Design|Clips|Content|Dispatch|General> [--force]It reads the run's analysis.json. Every system must be one analyze
scored. When the run has a bug.json, the plan becomes a bug plan:
- it adds a Trigger section, and quotes the report when it has no link;
- its paths are the focus files only;
- its frontmatter gets
trigger: bugand the report assource.
Plans go to <plansDir>/<run>/<slug>.md (see config.json).
Fill it
Replace every TODO(agent) marker, summary, and confidence, following
references/plan-guide.md. Keep slugs stable across runs. The
fingerprint comes from the systems and the slug, and Jira dedup keys on it.
A plan is finished when jira-refactor-findings' jira-upsert.ts accepts
it.
Trending
Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data
Who's talking about BuilderIO/agent-native
- @github-trending-js.bsky.social“📦 BuilderIO / agent-native ⭐ 4,978 (+89) 🗒 TypeScript A framework for building agentic apps”Bluesky · Sep 20, 2026 · 2 likes
- @github-trending-js.bsky.social“📦 BuilderIO / agent-native ⭐ 4,011 (+96) 🗒 TypeScript A framework for building agent-native applications.”Bluesky · Jul 26, 2026 · 2 likes
- @epicvibecoder.bsky.social“agent-native: a TypeScript framework from Builder.io for apps where AI agents are first-class users, not an …”Bluesky · Jun 20, 2026 · 2 likes
- @github-trending-js.bsky.social“🔥 Hot Repo! 🔥 (100+ new stars) 📦 BuilderIO / agent-native ⭐ 7,378 (+107) 🗒 TypeScript A framework for …”Bluesky · Oct 16, 2026 · 1 likes
- @dailygithubtrends.bsky.social“今日のGitHubトレンド BuilderIO/agent-native Agent-Nativeは、自律的に動作するエージェントと専用UIを組み合わせて開発するためのTypeScriptフレームワークです。…”Bluesky · Sep 23, 2026 · 1 likes
The biggest 5 of 61 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 61
Talked about on GitHub and Bluesky (61 times).
On GitHub · 50
- Oct 28, 2026agent-skills.github.builderio.agent-native: 0-unstable-2026-10-27 → 0.1.287 — sudosubin/agents.nix0 reactions
- Oct 28, 2026claude-code-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-27 → 0.1.287 — sudosubin/agents.nix0 reactions
- Oct 28, 2026codex-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-27 → 0.1.287 — sudosubin/agents.nix0 reactions
- Oct 28, 2026codex-plugins.github.builderio.agent-native: 0-unstable-2026-10-27 → 0.1.287 — sudosubin/agents.nix0 reactions
- Oct 28, 2026agent-plugins.github.builderio.agent-native: 0-unstable-2026-10-27 → 0.1.287 — sudosubin/agents.nix0 reactions
45 more on GitHub
- Oct 28, 2026claude-code-plugins.github.builderio.agent-native: 0-unstable-2026-10-26 → 0.1.287 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-skills.github.builderio.agent-native: 1a39024 → efdb9df — sudosubin/agents.nix0 reactions
- Oct 27, 2026claude-code-marketplaces.github.builderio.agent-native: 869063e → 06e5709 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-marketplaces.github.builderio.agent-native: ba4ef37 → 06e5709 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-plugins.github.builderio.agent-native: 55d65b3 → 0cc74c0 — sudosubin/agents.nix0 reactions
- Oct 27, 2026chore: update Agent Native exported skills — BuilderIO/skills0 reactions · 1 comment
- Oct 27, 2026agent-plugins.github.builderio.agent-native: 1fcca73 → cc341a4 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-plugins.github.builderio.agent-native: 36006e6 → 1fcca73 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-skills.github.builderio.agent-native: 3e6443d → 1a39024 — sudosubin/agents.nix0 reactions
- Oct 27, 2026claude-code-marketplaces.github.builderio.agent-native: 87ba124 → 869063e — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-marketplaces.github.builderio.agent-native: 12a91c6 → ba4ef37 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-plugins.github.builderio.agent-native: 7af9ac7 → 55d65b3 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-plugins.github.builderio.agent-native: e9d5ffa → 36006e6 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-skills.github.builderio.agent-native: 0-unstable-2026-10-26 → 0-unstable-2026-10-27 — sudosubin/agents.nix0 reactions
- Oct 27, 2026claude-code-marketplaces.github.builderio.agent-native: eaa780a → 87ba124 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-marketplaces.github.builderio.agent-native: 6b65dba → 12a91c6 — sudosubin/agents.nix0 reactions
- Oct 27, 2026claude-code-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-26 → 0-unstable-2026-10-27 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-26 → 0-unstable-2026-10-27 — sudosubin/agents.nix0 reactions
- Oct 27, 2026codex-plugins.github.builderio.agent-native: 0-unstable-2026-10-26 → 0-unstable-2026-10-27 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-plugins.github.builderio.agent-native: 0-unstable-2026-10-26 → 0-unstable-2026-10-27 — sudosubin/agents.nix0 reactions
- Oct 27, 2026agent-skills.github.builderio.agent-native: 7faf806 → 7397901 — sudosubin/agents.nix0 reactions
- Oct 26, 2026claude-code-marketplaces.github.builderio.agent-native: e0ebd6b → 5252c0e — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-marketplaces.github.builderio.agent-native: e0ebd6b → 5252c0e — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-plugins.github.builderio.agent-native: e0ebd6b → 5252c0e — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-plugins.github.builderio.agent-native: 0ab7e59 → 5dc9ffe — sudosubin/agents.nix0 reactions
- Oct 26, 2026claude-code-plugins.github.builderio.agent-native: 0-unstable-2026-10-22 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-skills.github.builderio.agent-native: d2739c6 → 7faf806 — sudosubin/agents.nix0 reactions
- Oct 26, 2026chore: update Agent Native exported skills — BuilderIO/skills0 reactions · 1 comment
- Oct 26, 2026claude-code-marketplaces.github.builderio.agent-native: eb073a4 → e0ebd6b — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-marketplaces.github.builderio.agent-native: eb073a4 → e0ebd6b — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-plugins.github.builderio.agent-native: eb073a4 → e0ebd6b — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-plugins.github.builderio.agent-native: 0-unstable-2026-10-25 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-skills.github.builderio.agent-native: 0-unstable-2026-10-25 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026claude-code-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-25 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-marketplaces.github.builderio.agent-native: 0-unstable-2026-10-25 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-plugins.github.builderio.agent-native: 0-unstable-2026-10-25 → 0-unstable-2026-10-26 — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-skills.github.builderio.agent-native: 1fe5d77 → 8505239 — sudosubin/agents.nix0 reactions
- Oct 26, 2026claude-code-marketplaces.github.builderio.agent-native: 1fe5d77 → 8505239 — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-marketplaces.github.builderio.agent-native: 1fe5d77 → 8505239 — sudosubin/agents.nix0 reactions
- Oct 26, 2026codex-plugins.github.builderio.agent-native: 1fe5d77 → 8505239 — sudosubin/agents.nix0 reactions
- Oct 26, 2026agent-plugins.github.builderio.agent-native: 1fe5d77 → 8505239 — sudosubin/agents.nix0 reactions
- Oct 22, 2026chore: update Agent Native exported skills — BuilderIO/skills0 reactions · 1 comment
- Oct 16, 2026[Candidate] builderio/agent-native - large collection (876 SKILL.md files) — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 15, 2026Builder.io, 에이전틱 앱 오픈소스 TS 프레임워크 'Agent-Native' 베타 출시 — UI·에이전트·HTTP·CLI·MCP·A2A 6개 서피스 공유 액션 (10/15, 공식 블로그) — roomedia/ax-trend0 reactions
- Oct 15, 2026Define human decisions once as schema-checked actions shared by the dashboard and factory mcp — mikeroySoft/factory0 reactions · 9 comments
On Bluesky · 11
- Sep 20, 2026📦 BuilderIO / agent-native ⭐ 4,978 (+89) 🗒 TypeScript A framework for building agentic apps — @github-trending-js.bsky.social2 likes and reposts
- Jul 26, 2026📦 BuilderIO / agent-native ⭐ 4,011 (+96) 🗒 TypeScript A framework for building agent-native applications. — @github-trending-js.bsky.social2 likes and reposts
- Jun 20, 2026agent-native: a TypeScript framework from Builder.io for apps where AI agents are first-class users, not an afterthought. Design once,… — @epicvibecoder.bsky.social2 likes and reposts · 1 reply
- Oct 16, 2026🔥 Hot Repo! 🔥 (100+ new stars) 📦 BuilderIO / agent-native ⭐ 7,378 (+107) 🗒 TypeScript A framework for building agentic apps — @github-trending-js.bsky.social1 likes and repost
- Sep 23, 2026今日のGitHubトレンド BuilderIO/agent-native Agent-Nativeは、自律的に動作するエージェントと専用UIを組み合わせて開発するためのTypeScriptフレームワークです。… — @dailygithubtrends.bsky.social1 likes and repost
6 more on Bluesky
- Sep 20, 2026📦 BuilderIO / agent-native ⭐ 4,978 (+89) 🗒 TypeScript A framework for building agentic apps — @github-trending.bsky.social1 likes and repost
- Sep 20, 2026今日のGitHubトレンド BuilderIO/agent-native Agent-Nativeは、自律的な動作を行うエージェントと専用UIを統合して構築するためのTypeScriptフレームワークです。… — @dailygithubtrends.bsky.social1 likes and repost
- Jun 19, 2026今日のGitHubトレンド BuilderIO/agent-native Agent-Nativeは、リッチなUIと自律型エージェントを統合したアプリケーションを構築するためのオープンソースフレームワークです。… — @dailygithubtrends.bsky.social1 likes and repost
- Jun 19, 2026🔥 Hot Repo! 🔥 (100+ new stars) 📦 BuilderIO / agent-native ⭐ 819 (+172) 🗒 TypeScript A framework for building agent-native applications. — @github-trending.bsky.social1 likes and repost
- Jun 18, 2026🔥 Hot Repo! 🔥 (100+ new stars) 📦 BuilderIO / agent-native ⭐ 673 (+131) 🗒 TypeScript A framework for building agent-native applications. — @github-trending-js.bsky.social1 likes and repost
- Jun 23, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 BuilderIO / agent-native ⭐ 1,793 (+434) 🗒 TypeScript A framework for building agent-native… — @github-trending-js.bsky.social0 likes and reposts · 1 reply
Other versions11 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 11
- github/awesome-copilot★ 41ksame name
- hyperledger-cacti/cacti★ 416same name
- Cosmian/kms★ 368same name
- GangJaeYu/harness_loop_full_korean★ 4same name
- termenbox/termenbox★ 4same name
- momentmaker/kaijutsu★ 3same name
- DingGao1124/skills★ 2same name
- GA14-hub/claude-code-kit-ja★ 1same name
- khanashes/claude-skills★ 0same name
- ReaperOAK/ForgeOS★ 0same name
1 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository103 other files it gives its agents.
- AGENTS.mdAGENTS.md
- a2a-protocolSkill
- actionsSkill
- adding-a-featureSkill
- adding-tests-and-ciSkill
- adding-workspace-appsSkill
- address-feedbackSkill
- address-feedback-with-repliesSkill
- agent-native-docsSkill
- agent-native-toolkitSkill
- agent-pageSkill
- audit-logSkill
- authenticationSkill
- automationsSkill
- babysit-prSkill
- browser-sessionsSkill
- bug-traceSkill
- build-an-appSkill
- capture-learningsSkill
- changelogSkill
- chat-first-workbenchSkill
- client-methodsSkill
- client-side-routingSkill
- community-prsSkill
- composable-mini-appsSkill
- concurrent-agentsSkill
- configurationSkill
- context-awarenessSkill
- context-xraySkill
- create-skillSkill
- customizing-agent-nativeSkill
- data-programsSkill
- debug-runsSkill
- decisionsSkill
- delegate-to-agentSkill
- delegating-workSkill
- design-editor-reproSkill
- extension-pointsSkill
- extensionsSkill
- external-agentsSkill
- feature-flagsSkill
- fix-at-the-boundarySkill
- fragility-commonSkill
- framework-storesSkill
- frontend-designSkill
- generative-uiSkill
- harness-agentsSkill
- identify-fragile-systemsSkill
- integration-webhooksSkill
- internationalizationSkill
- investigate-bugSkill
- jira-refactor-findingsSkill
- launchdarklySkill
- multi-frontier-desktopSkill
- mvp-followupSkill
- native-navigationSkill
- new-branchSkill
- observabilitySkill
- onboardingSkill
- performanceSkill
- The first 60 shown.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

