omakaseagent 0.1.0

package/LICENSE

@@ -0,0 +1,182 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity exercising
+      permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but not
+      limited to compiled object code, generated documentation, and
+      conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions to
+      that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright
+      owner or by an individual or Legal Entity authorized to submit on
+      behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License.
+
+      Subject to the terms and conditions of this License, each Contributor
+      hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+      royalty-free, irrevocable copyright license to reproduce, prepare
+      Derivative Works of, publicly display, publicly perform, sublicense,
+      and distribute the Work and such Derivative Works in Source or Object
+      form.
+
+   3. Grant of Patent License.
+
+      Subject to the terms and conditions of this License, each Contributor
+      hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+      royalty-free, irrevocable (except as stated in this section) patent
+      license to make, have made, use, offer to sell, sell, import, and
+      otherwise transfer the Work, where such license applies only to those
+      patent claims licensable by such Contributor that are necessarily
+      infringed by their Contribution(s) alone or by combination of their
+      Contribution(s) with the Work to which such Contribution(s) was
+      submitted.
+
+   4. Redistribution.
+
+      You may reproduce and distribute copies of the Work or Derivative
+      Works thereof in any medium, with or without modifications, and in
+      Source or Object form, provided that You meet the following
+      conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works that
+          You distribute, all copyright, patent, trademark, and attribution
+          notices from the Source form of the Work, excluding those notices
+          that do not pertain to any part of the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one of
+          the following places: within a NOTICE text file distributed as
+          part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do not
+          modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions for
+      use, reproduction, or distribution of Your modifications, or for any
+      such Derivative Works as a whole, provided Your use, reproduction,
+      and distribution of the Work otherwise complies with the conditions
+      stated in this License.
+
+   5. Submission of Contributions.
+
+      Unless You explicitly state otherwise, any Contribution intentionally
+      submitted for inclusion in the Work by You to the Licensor shall be
+      under the terms and conditions of this License, without any
+      additional terms or conditions. Notwithstanding the above, nothing
+      herein shall supersede or modify the terms of any separate license
+      agreement you may have executed with Licensor regarding such
+      Contributions.
+
+   6. Trademarks.
+
+      This License does not grant permission to use the trade names,
+      trademarks, service marks, or product names of the Licensor, except
+      as required for reasonable and customary use in describing the origin
+      of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty.
+
+      Unless required by applicable law or agreed to in writing, Licensor
+      provides the Work (and each Contributor provides its Contributions)
+      on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+      either express or implied, including, without limitation, any
+      warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY,
+      or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for
+      determining the appropriateness of using or redistributing the Work
+      and assume any risks associated with Your exercise of permissions
+      under this License.
+
+   8. Limitation of Liability.
+
+      In no event and under no legal theory, whether in tort (including
+      negligence), contract, or otherwise, unless required by applicable
+      law (such as deliberate and grossly negligent acts) or agreed to in
+      writing, shall any Contributor be liable to You for damages,
+      including any direct, indirect, special, incidental, or consequential
+      damages of any character arising as a result of this License or out
+      of the use or inability to use the Work (including but not limited
+      to damages for loss of goodwill, work stoppage, computer failure or
+      malfunction, or any and all other commercial damages or losses),
+      even if such Contributor has been advised of the possibility of such
+      damages.
+
+   9. Accepting Warranty or Support.
+
+      When redistributing the Work or Derivative Works thereof, You may
+      choose to offer, and charge a fee for, acceptance of support,
+      warranty, indemnity, or other liability obligations and/or rights
+      consistent with this License. However, in accepting such obligations,
+      You may act only on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Rick Blalock
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/OMAKASE-CRITIQUE.md

@@ -0,0 +1,12 @@
+# Omakase Critique Rubric
+
+Use this rubric to judge every major output.
+
+- **Senior Expertise** — Does this output feel like it was created by a top-tier expert with many years of real experience?
+- **Zero AI Slop** — Is it completely free of generic AI patterns, fluff, unnecessary comments, defensive code, or synthetic tone?
+- **Ruthless Simplicity** — Is this the simplest possible solution that works? Were any opportunities to reduce complexity missed?
+- **Context Fidelity** — Does it perfectly respect the project's context, design principles, existing style, and architecture?
+- **Pragmatic Craftsmanship** — Is the code clean, maintainable, and pragmatic? No over-engineering or unnecessary abstraction.
+- **Taste & Voice** — Does the writing, design, or copy match our exact intended tone and brand voice?
+- **Structural Integrity** — Does it improve the codebase or output quality, or does it add bloat and scattered logic?
+- **Excellence Gate** — Would we be proud to ship this exactly as-is with zero revisions?

package/OMAKASE-PRINCIPLES.md

@@ -0,0 +1,15 @@
+# Omakase Principles
+
+This is not just another collection of AI agents. This is a standard.
+
+**Core Philosophy:**
+
+- Trust the chef — You state what you want. We decide how to get it done.
+- Specialization beats generalization — Every agent stays narrow and masterful at one thing.
+- Quality over speed — Mediocre work is never acceptable.
+- Senior taste is non-negotiable — Every output must feel like it came from a top-tier expert.
+- Anti-slop by design — We aggressively reject generic AI patterns in both code and communication.
+
+**Our Standard:**
+
+Everything we produce should feel like it was made by someone with deep expertise and impeccable taste. If it looks, feels, or behaves like typical AI output, it has failed.

package/OMAKASE-RULES.md

@@ -0,0 +1,25 @@
+# Omakase Agent Rules
+
+1. **Full Context First** — Every agent must gather complete context before starting work. This includes project docs, recent conversation history, and any handoff notes.
+
+2. **Senior Craftsmanship** — All output must reflect senior-level taste. Code must be clean and pragmatic. No AI-looking patterns in code, design, or writing.
+
+3. **Zero Slop Policy** — Every major output is reviewed by a critique agent using a strict rubric. It must pass before being delivered.
+
+4. **Explain Your Taste** — Every non-trivial output must include a short “Why this approach” section showing senior-level reasoning.
+
+5. **Persistent Taste Memory** — The system maintains `.omakaseagent/taste.md` (project-specific taste + rejections) and `decisions.md` (key choices with Context/Decision/Why/Revisit if) at project root. These are sacred files that the Omakase skill **must read on every significant task** (see SKILL.md Setup). All agents cite specific entries in "Memory consulted" notes and "Why this approach" sections. Weak or absent memory is a Context Fidelity failure.
+
+6. **Clear Handoff Protocol** — When agents pass work between each other, they must include a concise summary of decisions and reasoning.
+
+7. **Self-Awareness** — If an agent lacks context or is uncertain, it must ask clarifying questions instead of guessing.
+
+8. **Excellence Gate** — Nothing mediocre gets delivered. Work only reaches you after passing critique.
+
+9. **Ruthless Simplicity** — Prefer simple, direct solutions unless complexity is clearly justified.
+
+10. **Tone & Voice Consistency** — All output must match the intended brand voice with zero generic AI fluff.
+
+11. **Proactive Quality** — Agents should proactively flag potential issues or suggest meaningful improvements.
+
+12. **Audit Trail** — Every major change includes a brief log of what was changed and why.

package/README.md

@@ -0,0 +1,96 @@
+# Omakase
+
+**The chef's standard.** One skill. Craftsman's taste. Zero AI slop.
+
+[![skills.sh](https://skills.sh/b/rblalock/omakaseagent)](https://skills.sh/rblalock/omakaseagent)
+
+Trust the chef — state the goal. Omakase applies the bar, remembers taste, and critiques before anything significant ships.
+
+## What it is
+
+Omakase is a **portable quality standard** for agent work: twelve rules, a critique rubric, and project memory (`.omakaseagent/taste.md`, `decisions.md`). Not a bag of prompts.
+
+Generic, hedging, over-engineered output fails. Non-trivial work explains *why* this approach.
+
+## Quick start
+
+```bash
+npx omakaseagent init
+npx omakaseagent learn    # repo-specific Level 4 factory (scenarios, gates)
+```
+
+Reload your harness, then talk to a **lead** (not a menu of skills):
+
+| Harness | Example |
+|---------|---------|
+| Cursor / Claude IDE | `@omakase-engineer add rate limiting with backoff` |
+| OpenCode | `opencode run --agent omakase-engineer "add rate limiting…"` |
+| Grok | `grok --agent omakase-engineer "…"` |
+| Claude CLI | `claude -p --agent omakase-critic "review the auth module"` |
+
+**Leads:** `@omakase-engineer` · `@omakase-critic` · `@omakase-archivist` — specialists stay internal; leads delegate.
+
+**Router skill** (`omakase-router`) is only for plan, taste, handoff, and init when you are not using a native lead:
+
+```
+/omakase-router plan <goal>
+/omakase-router critique <target>
+```
+
+Harness quirks, Codex names, and troubleshooting: [docs/NATIVE-SUBAGENTS.md](docs/NATIVE-SUBAGENTS.md).
+
+## The standard (always loaded)
+
+| File | Role |
+|------|------|
+| [OMAKASE-RULES.md](OMAKASE-RULES.md) | Twelve non-negotiable rules |
+| [OMAKASE-CRITIQUE.md](OMAKASE-CRITIQUE.md) | Rubric for major output |
+| [OMAKASE-PRINCIPLES.md](OMAKASE-PRINCIPLES.md) | Why this is a standard, not a prompt pack |
+
+Memory lives in `.omakaseagent/` after `init`.
+
+## Install
+
+**New project:**
+
+```bash
+npx omakaseagent init
+```
+
+**Skill + agents only** (harness already configured):
+
+```bash
+npx omakaseagent skills install          # auto-detect harness
+npx omakaseagent skills install cursor   # or: claude | agents | grok | codex
+```
+
+Also on the skills ecosystem: `npx skills add rblalock/omakaseagent` ([skills.sh](https://skills.sh/rblalock/omakaseagent)).
+
+**No terminal?** Omakase works in chat apps. Download
+[omakase-skill.zip](https://omakaseagent.com/omakase-skill.zip),
+then upload it in Claude (Customize → Skills → Upload skill) or ChatGPT
+(Skills → New skill → Upload from your computer). In chat
+you get the standard (rules + critique gate); the full kitchen (leads, project
+memory) needs a coding harness.
+
+Use `omakase skills install --no-native-agents` for skill-only. Verify artifacts: `npm run verify:native-agents`.
+
+## Developing this repo
+
+Source: `skill/`. Shipped bundles: `dist/` (committed — do not edit by hand).
+
+```bash
+npm link              # local CLI
+npm run build
+npm run verify:native-agents
+npx omakaseagent init      # dogfood in this clone
+npx omakaseagent learn     # factory layout for this repo
+```
+
+Level 4 methodology: [skill/reference/dark-factory.md](skill/reference/dark-factory.md). Multi-agent E2E: [examples/factory-e2e/](examples/factory-e2e/). Learn snapshot: [examples/factory-dogfood/](examples/factory-dogfood/).
+
+Do not commit local harness dirs (`.cursor/`, `.claude/`, etc.) — regenerate with `init`. Personas: `skill/teams/`.
+
+## License
+
+Apache 2.0