fluencyloop

Solid

FluencyLoop — stay fluent in code as AI writes it. Router/overview for the per-feature loop (design → build+teach → review), the optional up-front planning stage for large chunks, the woven-in constitution that grows from decisions, plus post-merge backfill. Use when the user mentions FluencyLoop, "fluency", the .fluencyloop/ directory, or wants to set up / understand the workflow but hasn't named a specific stage.

AI & Automation 44 stars 3 forks Updated 5 days ago Apache-2.0

Install

View on GitHub

Quality Score: 84/100

Stars 20%
55
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# FluencyLoop *The code and your fluency in it are produced together, or not at all.* ## Literal CLI Fast Path (Codex) This section takes priority over every later workflow instruction. If the developer gives a literal `fluencyloop` CLI command, such as `fluencyloop init`, `fluencyloop -v`, or `fluencyloop check`, they requested **only that command**. 1. For `fluencyloop init`, request sandbox elevation for that exact command before its first execution. It may create Codex-protected `.git` metadata; do not first attempt it in the standard sandbox. 2. Invoke `fluencyloop` immediately. 3. Do not send an interim update, inspect the workspace, read state, search the web, check PATH, or explain what the command will do. 4. Do not route to a stage or run a follow-up command after it succeeds. In particular, `fluencyloop init` must not automatically start a feature or plan. 5. Return the command's result concisely. If Codex requires approval for another write, request it before running the command; do not add setup narration. ## Bundled CLI (Codex) On macOS, Linux, Git Bash, and WSL, the trusted SessionStart hook maintains an owned `~/.local/bin/fluencyloop` shim for this installed plugin. Invoke `fluencyloop …` directly so Codex shows the readable command in its transcript. Do not resolve its path, check PATH, or describe the shim to the developer. If that command reports `command not found` because hooks have not run yet, invoke the bundled dispatcher from th...

Details

Author
baokhang83
Repository
baokhang83/fluencyloop
Created
1 months ago
Last Updated
5 days ago
Language
HTML
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

plan

FluencyLoop planning stage. Plan a large chunk of work before building it: design and document the overall architecture, break it into task items, sequence them into a roadmap with a critical path, and (optionally) open GitHub issues under a milestone. Produces a committed plan.md that the per-feature loop then builds from — one feature per task item. Use when the work is too big for a single feature/branch, or when the user says "fluencyloop plan", "plan this", "design the architecture for", "break this down", or "make a roadmap".

44 Updated 5 days ago
baokhang83
AI & Automation Solid

backfill

FluencyLoop safety net. Reconstruct store records for work that shipped without going through the loop — reads a merged diff, records the feature, session, decisions, knowledge, and architectural concepts, and defaults reconstructed decisions to unverified. Use post-merge, or when the user says "fluencyloop backfill", "document this PR after the fact", or "we skipped the loop on this one".

44 Updated 5 days ago
baokhang83
AI & Automation Solid

feature

FluencyLoop Stage 2–3. Declare a feature and build it while staying fluent: creates the feature branch, frames its concepts and relationships, then builds in slices, teaching the why of each real decision at the slice boundary and journaling it. Probes the concepts the work needs up front, adapts explanation depth to the developer's knowledge, and builds/maintains a per-developer knowledge base in ~/.fluencyloop. Use when starting a new unit of work in a repo that has a .fluencyloop/ directory, or when the user says "fluencyloop feature", "start a feature", or describes something they want to build with FluencyLoop.

44 Updated 5 days ago
baokhang83