how
A Cursor plugin that adds the /how skill: ask how a subsystem, feature, or flow works, and the agent produces a clear architectural explanation at the level of a senior engineer onboarding onto a new area.
Skill-based agent orchestration. Built in Go.
$ npx -y skills add poteto/noodle --agent claude-code
Repo: poteto/noodle
What's inside
Skill-based agent orchestration. Built in Go.
Give this to your agent:
Install Noodle and set up this project. Follow the instructions at
https://raw.githubusercontent.com/poteto/noodle/main/INSTALL.md
Or follow the getting started guide to set up manually.
Full documentation lives at noodle-run.github.io/noodle.
pnpm build # build
pnpm check # lint + test + vet
.agents/
hooks/
auto-index-brain.sh
block-sleep.sh
inject-brain.sh
skills/
adversarial-review/
references/
reviewer-lenses.md
reviewer-prompt.md
verdict-format.md
SKILL.md
ast-grep/
references/
rule_reference.md
SKILL.md
brain/
SKILL.md
codex/
SKILL.md
commit/
SKILL.md
debugging/
SKILL.md
execute/
references/
team-execution.md
verification.md
SKILL.md
find-skills/
SKILL.md
frontend-design/
LICENSE.txt
SKILL.md
go-best-practices/
references/
patterns.md
SKILL.md
interaction-design/
references/
animation-libraries.md
microinteraction-patterns.md
scroll-animations.md
SKILL.md
make-interfaces-feel-better/
references/
animations.md
performance.md
surfaces.md
typography.md
SKILL.md
meditate/
references/
agents.md
scripts/
snapshot.sh
SKILL.md
noodle/
references/
configuration.md
skill-authoring.md
SKILL.md
oops/
SKILL.md
plan/
references/
domain-skills.md
templates.md
SKILL.md
quality/
references/
stage-message-schema.md
SKILL.md
react-best-practices/
references/
_sections.md
advanced-event-handler-refs.md
advanced-init-once.md
advanced-use-latest.md
async-api-routes.md
async-defer-await.md
async-dependencies.md
async-parallel.md
bundle-barrel-imports.md
bundle-conditional.md
bundle-defer-third-party.md
bundle-preload.md
client-event-listeners.md
client-localstorage-schema.md
client-passive-event-listeners.md
client-swr-dedup.md
js-batch-dom-css.md
js-cache-function-results.md
js-cache-property-access.md
js-cache-storage.md
js-combine-iterations.md
js-early-exit.md
js-hoist-regexp.md
js-index-maps.md
js-length-check-first.md
js-min-max-loop.md
js-set-map-lookups.md
js-tosorted-immutable.md
rendering-animate-svg-wrapper.md
rendering-conditional-render.md
rendering-content-visibility.md
rendering-hoist-jsx.md
rendering-svg-precision.md
rendering-usetransition-loading.md
rerender-defer-reads.md
rerender-dependencies.md
rerender-derived-state-no-effect.md
rerender-derived-state.md
rerender-functional-setstate.md
rerender-lazy-state-init.md
rerender-memo-with-default-value.md
rerender-memo.md
rerender-move-effect-to-event.md
rerender-simple-expression-in-memo.md
rerender-transitions.md
rerender-use-ref-transient-values.md
useeffect-alternatives.md
useeffect-anti-patterns.md
SKILL.md
refine/
SKILL.md
reflect/
SKILL.md
review/
SKILL.md
ruminate/
scripts/
extract-conversations.py
SKILL.md
schedule/
references/
events.md
examples.md
model-routing.md
SKILL.md
skill-creator/
LICENSE.txt
references/
output-patterns.md
workflows.md
scripts/
init_skill.py
package_skill.py
quick_validate.py
SKILL.md
testing/
references/
fixtures.md
SKILL.md
todo/
SKILL.md
ts-best-practices/
references/
patterns.md
SKILL.md
unslop/
SKILL.md
worktree/
SKILL.md
.air.toml
.air.verbose.toml
.claude/
agents
hooks
settings.json
skills
.codex/
config.toml
.githooks/
commit-msg
.github/
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
workflows/
docs.yml
release.yml
test.yml
.gitignore
.goreleaser.yml
.noodle.toml
.vscode/
extensions.json
adapter/
fixture_test.go
runner_test.go
runner.go
sync.go
testdata/
backlog-missing-id/
expected.md
state-01/
input.ndjson
backlog-sync/
expected.md
state-01/
input.ndjson
backlog-with-plan/
expected.md
state-01/
input.ndjson
types.go
adapters/
main.go
README.md
app_helpers.go
brain/
architecture.md
archive/
completed_todos.md
plans/
01-noodle-extensible-skill-layering/
overview.md
phase-01-scaffold.md
phase-02-config.md
phase-03-skill-resolver.md
phase-04-ndjson-pipeline.md
phase-05-event-log.md
phase-06-spawner.md
phase-07-monitor.md
phase-08-adapters-mise.md
phase-09-scheduling-loop.md
phase-10-cli.md
phase-11-default-skills.md
phase-12-debate.md
phase-13-tui.md
phase-14-bootstrap-readme.md
102-config-cleanup/
overview.md
phase-01-remove-recovery.md
phase-02-remove-ticket-staleness.md
phase-03-remove-stuck-detection.md
phase-04-remove-routing-tags.md
phase-05-remove-monitor-section.md
phase-06-rename-max-cooks.md
phase-07-hardcode-concurrency-internals.md
phase-08-shutdown-behavior.md
108-orders-dsl/
overview.md
phase-01-compact-types.md
phase-02-promotion.md
phase-03-schema-and-skill.md
sketch.md
112-codebase-simplification-audit/
overview.md
phase-01-canonical-model.md
phase-02-loop-orchestration.md
phase-03-ws-lifecycle.md
113-deterministic-completion-detection/
overview.md
phase-01-session-outcome-type.md
phase-02-completion-tracker.md
phase-03-wire-tracker-into-session-base.md
phase-04-replace-terminal-status.md
phase-05-sprites-session-alignment.md
phase-06-sprites-heartbeat.md
phase-07-graceful-shutdown.md
phase-08-evaluate-monitor-repair.md
phase-09-delete-legacy.md
114-agent-native-onboarding/
overview.md
phase-01-install-md.md
phase-02-cli-welcome.md
phase-03-onboarding-route.md
phase-04-empty-states.md
phase-05-readme-update.md
15-bootstrap-onboarding/
overview.md
phase-01-scaffold.md
phase-02-homebrew-tap-and-binary-distribution.md
phase-03-first-run-setup.md
phase-04-auto-generated-noodle-skill.md
phase-05-install-md.md
phase-06-philosophy-md.md
phase-07-integration-test.md
20-onboarding/
overview.md
phase-01-docs-scaffold.md
phase-02-readme.md
phase-03-config-reference.md
phase-04-concept-skills.md
phase-05-concept-scheduling.md
phase-06-concept-brain-modes.md
phase-07-examples.md
phase-08-getting-started.md
phase-09-deploy.md
reference-docs-site-mockup.html
21-fixture-directory-redesign/
overview.md
phase-01-scaffold.md
phase-02-fixture-directory-contract-and-loader.md
phase-03-metadata-and-assertion-contract.md
phase-04-parse-adapter-stamp-migration.md
phase-05-event-monitor-spawner-migration.md
phase-06-loop-state-snapshot-model.md
phase-07-loop-fixture-migration.md
phase-08-fixture-validator-and-tooling.md
phase-09-cleanup-and-final-verification.md
23-task-type-skill-suite/
overview.md
phase-01-dynamic-task-registry.md
phase-02-native-planning.md
phase-03-context-injection.md
phase-04-prioritize.md
phase-05-quality.md
phase-06-execute.md
phase-07-reflect.md
phase-08-meditate.md
phase-09-oops.md
phase-10-debate.md
phase-11-utility-skills.md
phase-12-cleanup.md
25-tui-revamp/
overview.md
phase-01-subtract-gut-old-tui.md
phase-02-scaffold-layout-framework-and-pastel-palette.md
phase-03-reusable-components.md
phase-04-feed-tab.md
phase-05-queue-tab.md
phase-06-brain-tab-with-glamour-markdown.md
phase-07-config-tab-and-autonomy-dial.md
phase-08-review-flow-and-verdict-actions.md
phase-09-navigation-steer-and-polish.md
26-context-usage-tracking/
overview.md
phase-01-extend-canonical-events-with-context-metrics.md
phase-02-enrich-session-metadata-with-context-fields.md
phase-03-add-skill-attribution-to-canonical-events.md
phase-04-surface-context-metrics-in-mise-json.md
phase-05-add-context-efficiency-to-quality-skill.md
phase-06-add-context-audit-to-meditate-skill.md
phase-07-surface-context-metrics-in-tui.md
27-remote-dispatchers/
overview.md
phase-01-backend-interfaces-and-shared-types.md
phase-02-dispatcher-factory-and-runtime-routing.md
phase-03-streamingdispatcher-generic-implementation.md
phase-04-pollingdispatcher-generic-implementation.md
phase-05-spritesbackend-implementation.md
phase-06-cursorbackend-implementation.md
phase-07-monitor-observer-abstraction.md
phase-08-config-and-provider-validation.md
phase-09-tui-remote-session-indicator.md
phase-10-minimal-sync-back-for-remote-runtimes.md
phase-11-integration-wiring-and-end-to-end-test.md
28-rename-prioritize-to-schedule/
overview.md
phase-01-update-constants-and-types.md
phase-02-rename-config-struct-and-toml-section.md
phase-03-rename-loop-functions-and-logic.md
phase-04-rename-skill-directory-and-frontmatter.md
phase-05-update-tui-references.md
phase-06-update-tests-and-test-data.md
phase-07-update-docs-brain-and-generated-code.md
29-queue-item-context-passthrough/
overview.md
phase-01-add-extra-prompt-field-to-queueitem.md
phase-02-inject-extra-prompt-into-cook-prompt.md
phase-03-update-schedule-skill-and-schema-docs.md
phase-04-tests.md
phase-05-atomic-plan-removal-and-skill-rewrite.md
phase-06-first-run-backlog-adapter-bootstrap.md
phase-07-delete-plans-sync-and-clean-up.md
31-structured-loop-logging/
overview.md
phase-01-logger-type-and-interface.md
phase-02-inject-logger-into-loop.md
phase-03-log-dispatch-and-completion-events.md
phase-04-log-queue-mutations-and-state-transitions.md
phase-05-tests.md
34-failed-target-reset-runtime/
overview.md
phase-01-make-failed-target-reload-correct-and-explicit.md
phase-02-add-clear-failed-control-command.md
phase-03-fix-ui-retry-to-use-order-id.md
phase-04-verify-with-focused-loop-server-and-ui-tests.md
37-skip-prioritize-with-queue/
overview.md
phase-01-add-bootstrap-skip-logic.md
phase-02-tests.md
38-resilient-skill-resolution/
overview.md
phase-01-remove-dead-skill-config.md
phase-02-non-fatal-skill-resolution.md
phase-03-remove-runtime-repair.md
phase-04-fsnotify-skill-watcher.md
phase-05-registry-rebuild-queue-audit.md
phase-06-dispatch-rescan-fallback.md
phase-07-prioritize-bootstrap-agent.md
phase-08-tui-skill-lifecycle-events.md
39-charmbracelet-v2-upgrade/
overview.md
phase-01-phase-1-baseline-and-module-path-migration.md
phase-02-phase-2-bubble-tea-view-and-program-lifecycle-migration.md
... 1370 moreA Cursor plugin that adds the /how skill: ask how a subsystem, feature, or flow works, and the agent produces a clear architectural explanation at the level of a senior engineer onboarding onto a new area.
FAQ
noodle is a Claude Code plugin with 1 hand-picked skill for agent orchestration work, indexed on Flowy. Install it with the command on its page. It includes skill-creator. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.