index.html

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Howware · From know-how to done</title>
<meta name="description" content="Howware: your know-how, put to work by AI. State the rules in your own words; an AI agent follows them, with a few exact tools and a memory you own. No app to build, no one to hand it off to, no waiting.">
<meta property="og:title" content="Howware · From know-how to done">
<meta property="og:description" content="Your know-how, put to work by AI. No app to build, no one to hand it off to, no waiting. The next step after the spreadsheet.">
<meta property="og:type" content="website">
<meta property="og:url" content="https://howware.org/">
<link rel="alternate" hreflang="es" href="https://howware.org/es/">
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%235a45d6'/%3E%3Cpath d='M10 9v14M22 9v14M10 16h12' stroke='white' stroke-width='3' stroke-linecap='round'/%3E%3C/svg%3E">
<link rel="stylesheet" href="assets/style.css">
</head>
<body>

<header class="nav">
  <div class="wrap">
    <a class="brand" href="./"><span class="logo" aria-hidden="true"><svg width="15" height="15" viewBox="0 0 16 16" fill="none"><path d="M4 2.5v11M12 2.5v11M4 8h8" stroke="#fff" stroke-width="2.2" stroke-linecap="round"/></svg></span>howware</a>
    <nav>
      <a href="#why">Why</a>
      <a href="#anatomy">Anatomy</a>
      <a href="#principles">Principles</a>
      <a href="#build">Build one</a>
      <a href="https://github.com/howware/howware/blob/main/docs/whitepaper.md">Whitepaper</a>
      <a class="keep" href="https://github.com/howware/howware">GitHub</a>
      <a class="keep lang" href="es/" hreflang="es" lang="es">ES</a>
    </nav>
  </div>
</header>

<main>
  <section class="hero">
    <div class="wrap hero-grid">
      <div>
        <span class="eyebrow">An open idea · manifesto, whitepaper, spec and tools</span>
        <h1>From know-how<br>to <span class="hl">done</span>.</h1>
        <p class="lead"><b>Howware</b> is your know-how, put to work by AI. You state the rules in your own words; an AI agent follows them, with a few exact tools and a memory you own.</p>
        <div class="cta">
          <a class="btn primary" href="https://github.com/howware/howware/blob/main/MANIFESTO.md">Read the manifesto</a>
          <a class="btn" href="#build">Build a howware</a>
        </div>
        <div class="slogans"><span>No app.</span><span>No handoff.</span><span>No waiting.</span><span>Your rules, in your words, working today.</span></div>
      </div>
      <div class="term" role="img" aria-label="Example conversation with a personal finance howware">
        <div class="term-bar"><i></i><i></i><i></i><b>a personal-finance howware</b></div>
<pre><span class="u">› Yesterday I spent 180 on lunch, in cash.</span>
<span class="ok">✓</span> Recorded, with your words as evidence.

<span class="u">› OXXO is groceries, not convenience.</span>
<span class="ok">✓</span> New rule, applied to your whole history.

<span class="u">› How am I doing with my grocery budget?</span>
$3,180.40 of $4,000.00 (79 %).
<span class="p">$819.60 left for 9 days.</span></pre>
      </div>
    </div>
  </section>

  <section class="alt">
    <div class="wrap">
      <div class="layers">
        <div class="layer"><div class="k">Hardware</div><b>runs it.</b><span>The machines.</span></div>
        <div class="layer"><div class="k">Software</div><b>executes it.</b><span>The instructions they follow.</span></div>
        <div class="layer now"><div class="k">Howware</div><b>knows how.</b><span>Your know-how, put to work by an agent.</span></div>
      </div>
    </div>
  </section>

  <section id="why">
    <div class="wrap">
      <h2>The handoff problem</h2>
      <p class="sub">The person who knows how something should work is almost never the person who builds it. Meaning gets lost in translation, every rule makes the code more complicated, and every change waits its turn.</p>
      <div class="lanes">
        <div class="lane old">
          <h3>Today</h3>
          <div class="flow"><span class="step">You know the rules</span><span class="arrow">→</span><span class="step">Explain them</span><span class="arrow">→</span><span class="step">Someone codes them</span><span class="arrow">→</span><span class="step">Queue</span><span class="arrow">→</span><span class="step slow">Weeks or months</span></div>
          <p>And around the rules, an app — screens, forms, a backend — that everyone has to learn.</p>
        </div>
        <div class="lane new">
          <h3>With howware</h3>
          <div class="flow"><span class="step">You know the rules</span><span class="arrow">→</span><span class="step">Say them in your words</span><span class="arrow">→</span><span class="step fast">Working in the next conversation</span></div>
          <p>Code only for what must be exact — reading documents, money, dates, storage — in small tools that rarely change.</p>
        </div>
      </div>
    </div>
  </section>

  <section class="alt">
    <div class="wrap">
      <h2>The next step after the spreadsheet</h2>
      <p class="sub">The spreadsheet was the first time people who don't program could put their own know-how to work without asking anyone. Howware takes the same idea further.</p>
      <div class="tablewrap">
        <table class="cmp">
          <thead><tr><th></th><th>Spreadsheet</th><th>Howware</th></tr></thead>
          <tbody>
            <tr><td>Rules are written as</td><td>Formulas</td><td>Your own words</td></tr>
            <tr><td>The interface is</td><td>A grid</td><td>A conversation</td></tr>
            <tr><td>Data gets in by</td><td>Typing or pasting</td><td>Tools that read your documents</td></tr>
            <tr><td>Who does the work</td><td>You, cell by cell</td><td>An AI agent, following your rules</td></tr>
            <tr><td>A change takes effect</td><td>When you type it</td><td>In the next conversation</td></tr>
          </tbody>
        </table>
      </div>
    </div>
  </section>

  <section id="anatomy">
    <div class="wrap">
      <h2>What a howware is made of</h2>
      <p class="sub">Five parts. The agent that runs it — Claude Code, Codex or another — is not one of them, just as the browser is not part of a web page.</p>
      <div class="grid5">
        <div class="card"><div class="ic" aria-hidden="true"><svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M6 3h8l4 4v12.5A1.5 1.5 0 0 1 16.5 21h-9A1.5 1.5 0 0 1 6 19.5z"/><path d="M14 3v4h4"/><path d="M9 11h6M9 14h4"/><path d="m9 17.6 1.4 1.4 2.8-2.8"/></svg></div><h3>Protocol</h3><p>Your know-how in plain words: steps, criteria, rules, what to ask, what never to do. You can read it and change it.</p></div>
        <div class="card"><div class="ic" aria-hidden="true"><svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="2.5" y="8" width="19" height="8" rx="1.8"/><path d="M6 8v4M9 8v2.5M12 8v4M15 8v2.5M18 8v4"/></svg></div><h3>Tools</h3><p>Small programs for the exact operations of the job: money in cents, dates, identifiers, reports.</p></div>
        <div class="card"><div class="ic" aria-hidden="true"><svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M2.5 12h3"/><rect x="5.5" y="8.5" width="5" height="7" rx="1.5"/><path d="M10.5 10.5h2.5M10.5 13.5h2.5"/><path d="M21.5 6.5h-5A1.5 1.5 0 0 0 15 8v8a1.5 1.5 0 0 0 1.5 1.5h5"/></svg></div><h3>Adapters</h3><p>Shared programs that connect howwares to your documents and data, and remove personal data at the edge.</p></div>
        <div class="card"><div class="ic" aria-hidden="true"><svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M8 4.5h10A1.5 1.5 0 0 1 19.5 6v10"/><rect x="4.5" y="8" width="12" height="12.5" rx="1.8"/><circle cx="10.5" cy="14.25" r="3.2"/><path d="M10.5 12.6v1.65l1.1 1.1"/></svg></div><h3>Memory</h3><p>Your data and the rules you teach, in a place you own, with history. Nothing is silently overwritten.</p></div>
        <div class="card"><div class="ic" aria-hidden="true"><svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M4.5 4h9a2 2 0 0 1 2 2v4.5a2 2 0 0 1-2 2H9.5l-3 2.5v-2.5h-2a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z"/><path d="M17.5 9h2a2 2 0 0 1 2 2v4.5a2 2 0 0 1-2 2h-1V20l-3-2.5H13a2 2 0 0 1-2-2V15"/></svg></div><h3>Conversation</h3><p>The only interface. You say what you need; the agent asks when something is unclear.</p></div>
      </div>
    </div>
  </section>

  <section id="principles" class="alt">
    <div class="wrap">
      <h2>Nine principles</h2>
      <p class="sub">From the <a href="https://github.com/howware/howware/blob/main/MANIFESTO.md">manifesto</a>.</p>
      <ol class="principles">
        <li><b>The person with the know-how is the author.</b>No translation to a developer, no queue.</li>
        <li><b>The conversation is the interface.</b>No screens to build, no menus to learn.</li>
        <li><b>Code only what must be exact.</b>Judgment lives in words; exactness lives in tested tools.</li>
        <li><b>The agent decides; the tools do the work.</b>It never transcribes records or does the arithmetic.</li>
        <li><b>The person approves.</b>The agent proposes; nothing outward-facing without an explicit request.</li>
        <li><b>The person owns the data.</b>Readable, portable, with history.</li>
        <li><b>Privacy by design, stated honestly.</b>Minimize what reaches the model; say what you can't guarantee.</li>
        <li><b>Small enough to audit.</b>A text file and a few short tools anyone can read.</li>
        <li><b>Composable and open.</b>Open pieces, each useful alone — not a sealed product.</li>
      </ol>
    </div>
  </section>

  <section>
    <div class="wrap grid2">
      <div>
        <h2>Honest limits</h2>
        <ul class="plain">
          <li><b>There is still code</b> — less, and only where exactness matters.</li>
          <li><b>Words are less precise than formulas</b>, so the agent proposes, you approve, and exact operations live in tested tools.</li>
          <li><b>What the agent sees leaves your computer</b> for your AI provider. Every howware states what stays local, what the agent sees and what it cannot guarantee.</li>
        </ul>
      </div>
      <div>
        <h2>When not to use it</h2>
        <ul class="plain">
          <li>Visual or spatial work: design, maps, video, games.</li>
          <li>Real-time or high-frequency work: trading, live dashboards, point of sale.</li>
          <li>When a button's milliseconds matter more than flexibility.</li>
          <li>Jobs with no judgment in them — a script or a spreadsheet may be simpler.</li>
        </ul>
        <p style="color:var(--text-2);margin:14px 0 0">The test: <i>if you removed the screens from the app you have in mind, would most of its value remain?</i></p>
      </div>
    </div>
  </section>

  <section id="build" class="alt install">
    <div class="wrap grid2">
      <div>
        <h2>Build a howware</h2>
        <p class="sub" style="margin-bottom:24px">Two skills for Claude Code and Codex: one builds a howware with you, the other reviews it against the specification.</p>
        <h3>1 · Install the skills</h3>
<pre>git clone https://github.com/howware/howware
python howware/tools/install_skills.py</pre>
        <h3>2 · Install the memory</h3>
<pre>git clone https://github.com/howware/long-term-memory-for-AI
python long-term-memory-for-AI/tools/install_skill.py \
  --target ~/.claude/skills/project-memory</pre>
        <h3>3 · Tell your agent</h3>
<pre>I want to turn the way I &lt;do something&gt; into a howware.</pre>
      </div>
      <div>
        <h2 style="font-size:24px">Howwares</h2>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/finanzas-personales">finanzas-personales</a></h3>
          <p>Personal finances with no app: bank statements read and anonymized on your computer, categories that learn as rules, cash in a sentence, budgets with history, card payment reminders, monthly close. An optional module looks ahead: credits and mortgages, weekly to yearly forecasts and a debt payoff plan that adjusts as you go.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/todo">todo</a></h3>
          <p>Getting Things Done without an app: capture without friction, clarify, "what do I do now?", reminders until things are done, and the GTD weekly review — with your own areas and rules. <a href="https://github.com/howware/todo/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/facturacion">facturacion</a></h3>
          <p>Invoicing for Mexican freelancers: the deposits in your bank statements become the invoices to issue, with exact amounts, checked against what was stamped, through the declaration and its payment. <a href="https://github.com/howware/facturacion/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/arrendamiento">arrendamiento</a></h3>
          <p>Rentals for landlords: the rent checked against your bank statements and applied to the month it pays; services, property tax, repairs with their warranties, the yearly increase and the deposit, in one list of what is pending. It shares the memory with invoicing, so a rent paid early is invoiced for the right month. <a href="https://github.com/howware/arrendamiento/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/repaso">repaso</a></h3>
          <p>Learn and don't forget: tell your agent what you want to learn, or what you just learned. It makes the cards, quizzes you five minutes a day, grades your answers in your own words and brings each card back right before you would forget it, scheduled with FSRS, the algorithm Anki uses. Study plans for long topics and a streak without guilt. Any subject, any language. <a href="https://github.com/howware/repaso/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/bitacora">bitacora</a></h3>
          <p>Your journal, like a bullet journal without an app: tell your agent what you did and what happened today. It keeps your habits exact (sleep, the gym, water, whatever you choose to track), your notes with their signifiers (– note, ○ event, ! idea), and the collections you build as you go (books, movies, ideas), with your streaks and the month's grid. It never nags you to log, and once a month walks you through a reflection where you decide what continues. It shares its memory with todo, so a to-do you mention lands in your inbox. No health advice: just your own record. <a href="https://github.com/howware/bitacora/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <div class="card" style="margin-top:12px">
          <h3><a href="https://github.com/howware/eventos-sociales">eventos-sociales</a></h3>
          <p>Planning a wedding, XV años or a baptism? Tell your agent the date. A countdown template says what to do and when, from twelve months before to the thank-you notes, and you add, move or drop steps; if the date changes, everything moves with it. Starting late is fine: it separates what was already due and helps you choose what comes first. It keeps the budget, vendors, payments and who made them, the padrinos, the guest list with RSVPs and the tables exact. For couples and for wedding planners with several events. <a href="https://github.com/howware/eventos-sociales/blob/main/docs/building.md">See how it was built</a>.</p>
        </div>
        <h2 style="font-size:24px;margin-top:28px">Adapters</h2>
        <p class="sub" style="margin-bottom:0">Shared by howwares, each in its own repository.</p>
        <ul class="plain">
          <li><a href="https://github.com/howware/long-term-memory-for-AI">project-memory</a> — the owner's memory: local, append-only, with history.</li>
          <li><a href="https://github.com/howware/mx-bank-statement-reader">mxbank</a> — Mexican bank statements to anonymized, reconciled JSON.</li>
          <li><a href="https://github.com/howware/mx-sat-documents">mxsat</a> — SAT invoices and declaration receipts, with personal data kept local.</li>
        </ul>
        <h3 style="margin-top:22px">Read more</h3>
        <ul class="plain">
          <li><a href="https://github.com/howware/howware/blob/main/MANIFESTO.md">Manifesto</a> — the definition and nine principles.</li>
          <li><a href="https://github.com/howware/howware/blob/main/docs/whitepaper.md">Whitepaper</a> — patterns, anti-patterns, privacy, limits, comparison.</li>
          <li><a href="https://github.com/howware/howware/blob/main/docs/spec.md">Specification</a> — what a howware must have, and a conformance checklist.</li>
          <li><a href="https://github.com/howware/howware/tree/main/template">Template</a> — a working howware skeleton.</li>
        </ul>
      </div>
    </div>
  </section>

  <section>
    <div class="wrap">
      <h2>Where it goes next</h2>
      <p class="sub">Explored in the open, with the same principles.</p>
      <div class="road">
        <div class="cur"><span class="tag">Today</span><h3>Personal</h3><p>One person, one machine, one memory. Personal finance is the first howware.</p></div>
        <div><span class="tag">Next</span><h3>Teams</h3><p>Shared memory, roles, approvals and audit: who may change which rules, and who said what.</p></div>
        <div><span class="tag">Later</span><h3>Enterprise</h3><p>Identity, permissions, compliance, signed protocol packages and evaluation across model versions.</p></div>
      </div>
    </div>
  </section>

  <section class="alt">
    <div class="wrap">
      <p class="quote">Hardware runs it. Software executes it. <span>Howware knows how.</span></p>
    </div>
  </section>
</main>

<footer>
  <div class="wrap">
    <p>Howware is an open idea by Alfredo Pinto. Texts under CC BY 4.0, code under Apache 2.0. Not affiliated with any AI provider; Claude Code and Codex are trademarks of their owners.</p>
    <nav>
      <a href="https://github.com/howware/howware">GitHub</a>
      <a href="https://github.com/howware/howware/blob/main/MANIFESTO.md">Manifesto</a>
      <a href="https://github.com/howware/howware/blob/main/docs/whitepaper.md">Whitepaper</a>
      <a href="es/" hreflang="es" lang="es">Español</a>
    </nav>
  </div>
</footer>

</body>
</html>