Skip to main content
GiuSo
Contact

01Projects

22 research repositories · 8 commissioned · 1 campaign

The full index

Everything, in one list. The research entries are described from their own code, read on August 25, 2026, not from their repository names.

02Research and development

Research and development

Repositories from a single year of building. Each one carries its own harness, and the counts below were measured on disk.

Employer or client work. The problem, the architecture and the AI method are mine to describe; the product, the client and the business rules are not.

  • Year 2026

    Prompt-to-Tablature Trainer

    Type what you want to play and an LLM returns a tablature score. The app plays it back on a scrolling timeline, with the finger positions on a fretboard and synthesised audio. A later phase added a 24-week study plan with its own trainers for metronome, ear training, fretboard quiz, scales, legato and rhythm reading, each keeping its own session metrics.

    React, Tone.js, OpenAI, Feature-Sliced Design

    Harness

    • 3 subagents
    • 3 context docs
    • 1 decision record
    • 18 plans
    • Instruction file
  • Year 2026

    Live Call Interpreter

    A Windows desktop app that translates speech during a call, so each side hears the other in their own language. The audio is bridged through virtual devices into a realtime speech-to-speech model. Captions, an ASR correction dictionary and the knowledge bases sit in local SQLite behind hexagonal ports, with fake adapters so the whole app runs in development and in CI without touching a paid API.

    Electron, React, SQLite, Hexagonal architecture

    Harness

    • 22 rules
    • 52 skills
    • 14 subagents
    • 5 hooks
    • 94 context docs
    • 7 decision records
    • 32 plans
    • Instruction file
  • Year 2026

    Veterinary History Reader

    Scanned lab reports, prescriptions and follow-up notes for a single patient become a navigable record. An exam timeline, per-analyte trend charts, and one toggle that rewrites the same finding for the owner or for the vet. The AI interpretations are generated once and committed as data, so the page that renders them makes no model call at request time.

    Next.js, Gemini, Recharts

    Harness

    • 22 rules
    • 52 skills
    • 15 subagents
    • 5 hooks
    • 72 context docs
    • 1 decision record
    • 2 plans
    • Instruction file
  • Year 2026

    Script-to-Short Pipeline

    A conversation with an agent that scripts and storyboards first. It then generates the images and clips and assembles them with FFmpeg into a finished vertical short. Every stage is a schema-checked document: brief, bible, script, storyboard, shot list, cut plan, delivery. Quality gates sit between them, and a ledger records what was generated, so a rejected shot is re-run instead of the whole video.

    Node.js, FFmpeg, JSON Schema, React

    Harness

    • 12 skills
    • 5 subagents
    • 7 hooks
    • 84 context docs
    • 2 decision records
    • 9 plans
    • Instruction file
  • Year 2026

    Document-to-Warehouse Pipeline

    Client documents are ingested and turned into typed output tables in a cloud warehouse. It is driven by a daemon, a web console and a CLI that all read one shared schema package. Bringing a new client on is an idempotent script that provisions its dataset, so the same command can run twice without creating a second one.

    Fastify, Next.js, BigQuery, pnpm workspaces

    Harness

    • 22 rules
    • 53 skills
    • 15 subagents
    • 5 hooks
    • 159 context docs
    • 2 decision records
    • 32 plans
  • Year 2026

    Conversational Report Builder

    A multi-tenant reporting product where a page is not a hand-built dashboard. It is a set of blocks resolved through a semantic layer that binds a metric to a data contract to a tenant. An assistant authors and edits those blocks and metrics as tools rather than as chat, and an eval and drift-detection suite runs against it, because a report builder that quietly changes a definition is worse than one that fails.

    Next.js, BigQuery, Firestore, Mastra

    Harness

    • 22 rules
    • 57 skills
    • 19 subagents
    • 5 hooks
    • 88 context docs
    • 100 decision records
    • 119 plans
    • Instruction file
  • Year 2026

    Remote Agent Delegation Server

    An MCP server that exposes one machine's coding agent to a remote client over a private network. A task can be handed to the workstation at home from anywhere. Each delegated task runs inside its own cloned repository and loads that project's harness, with a job store, a per-project queue and both synchronous and background modes.

    TypeScript, MCP, Node.js, Zod

    Harness

    • 22 rules
    • 52 skills
    • 14 subagents
    • 5 hooks
    • 72 context docs
    • 2 decision records
    • 2 plans
    • Instruction file
  • Year 2026

    Approval-Gated Operations Agent

    A multi-tenant application where an operator asks in plain language and gets an assembled answer. It comes from a vector knowledge base and per-tenant connectors into the systems of record. Financial writes are never executed by the agent: it proposes the action and a person approves it, which is the design decision the rest of the architecture exists to protect.

    Next.js, pgvector, Postgres, Mastra

    Harness

    • 23 rules
    • 57 skills
    • 14 subagents
    • 5 hooks
    • 87 context docs
    • 4 decision records
    • 82 plans
    • Instruction file
  • Year 2026

    Operator App Ahead of Its API

    An operator-facing app built and shipped before the API it consumes existed. A backend- for-frontend sat behind a port with mocked adapters, and that choice was recorded as a decision rather than a shortcut. Its conversation engine is deterministic behind an agent port, and identifiers are generated on the wire, so the records reconcile with that API the day it arrives.

    Next.js, Tauri, ULID, Zod

    Harness

    • 22 rules
    • 57 skills
    • 16 subagents
    • 5 hooks
    • 106 context docs
    • 10 decision records
    • 8 plans
    • Instruction file
  • Year 2026

    Auditable Lead Qualification Agents

    Configurable agents qualify a company from a public registry lookup. The data is enriched through third-party connectors, and the fit verdict is persisted together with the reasoning that produced it, so a rejected lead can be re-read months later. Workflow and skill configuration is stored as data rather than code, and the move from a deterministic pipeline to a multi-agent harness is written down as a decision record with what it cost.

    Next.js, Firestore, Mastra, OpenTelemetry

    Harness

    • 22 rules
    • 82 skills
    • 17 subagents
    • 5 hooks
    • 102 context docs
    • 21 decision records
    • 43 plans
    • Instruction file
  • Year 2026

    AI Video Production Studio

    A browser video studio where everything is generated through a chat interface. Scenes, characters, props, locations, narration, music and captions are assembled on a multi- lane timeline, then rendered and exported. Generation, transcription and rendering run as cloud functions, so the browser holds the edit and a render never blocks it.

    React, Firebase, Cloud Functions, Google GenAI

    Harness

    • 22 rules
    • 54 skills
    • 14 subagents
    • 5 hooks
    • 123 context docs
    • 2 decision records
    • 167 plans
    • Instruction file
  • Year 2026

    Shared Expense Settler

    A web app for splitting shared costs across a group. Participants join a session by code and log simple or itemised expenses, and the app computes each person's balance and the shortest set of payments that settles the group. Its design system was produced first, by an agent that interviews for tokens and patterns before any interface is built.

    Next.js, Firestore, Tailwind CSS

    Harness

    • 2 subagents
    • Instruction file
  • Year 2026

    Architecture-First Documentation Portal

    A documentation portal for a data-integration platform that does not exist yet. The repository holds no product code at all, only the architecture: decision records, sequence diagrams, and the frontend that renders them. It is the clearest single instance of the method, because nothing in it could have been produced by knowing how to code.

    React, Mermaid, TypeScript

    Harness

    • 29 decision records
    • Instruction file
  • Year 2026

    Single Sign-On App Shell

    A shell that hosts several internal web apps behind one sign-in. The user authenticates once and picks an app from the sidebar, and the shell propagates and refreshes the token to the embedded app through an origin-checked message handshake. Registered apps are records, so adding one is data entry rather than a deploy.

    Next.js, Firebase, Zod

    Harness

    • 9 rules
    • 12 skills
    • 3 subagents
    • 1 hook
    • 2 plans
    • Instruction file
  • Year 2026

    Client Onboarding Record System

    An internal system that holds client registration records and automates the onboarding that depends on them. It is organised by feature slice, with modules for records, contacts, products, external lookups, integrations and a metrics view. Every change writes to an audit trail, which is the part that mattered: the records carry personal data, so who changed what is not a nice-to-have.

    Next.js, Firestore, Zod, Feature-Sliced Design

    Harness

    • 1 rule
    • 21 skills
    • 7 subagents
    • 9 hooks
    • 4 decision records
    • 1 plan
    • Instruction file
  • Year 2026

    Agent-Written Test Suites

    A Python test framework whose suites are written by agents. A planner turns a feature description into a test plan, an architect shapes it, and an implementer emits the executable code against a shared layer of page objects, API clients and data factories. The value is not the tests it contains but that a described feature arrives as a runnable suite.

    Python, Pytest, Playwright, Allure

    Harness

    • 3 subagents
    • Instruction file
  • Year 2026

    Spreadsheet-to-Insight Reports

    Spreadsheets are loaded into a warehouse and turned into written insight reports per account. A model drafts the prose, and a review step renders it as email-ready HTML before anything is sent. The data side carries the unglamorous parts that decide whether it can be trusted: backup with expiry, conditional delete, upsert and restore.

    Next.js, BigQuery, Firestore, Gemini

    Harness

    • 9 rules
    • 12 skills
    • 4 subagents
    • 1 hook
    • 7 plans
    • Instruction file
  • Year 2026

    Gated Documentation Portal

    An internal portal that publishes product documentation to authenticated readers only, with passwordless sign-in by emailed code. A single-page frontend over a small REST API, running end to end in containers locally so the emulator, the API and the site come up with one command.

    React, Flask, Firestore, Docker

    Harness

    • 1 subagent
    • Instruction file
  • Year 2026

    Versioned Document Vault

    Document management over cloud storage, with a client and project tree and chunked upload. Versioning is automatic when a file of the same name returns, permissions are inherited with a per-user override, and share links can be open, password-protected or unlisted. A later pass collapsed projects and folders into one container type, so a project is simply its own root folder.

    Next.js, Firestore, Cloud Storage

    Harness

    • 9 rules
    • 12 skills
    • 3 subagents
    • 1 hook
    • 4 plans
    • Instruction file
  • Year 2026

    ERP Credential Scope Prober

    A tool that answers two questions about a set of ERP API credentials in real time. Are they valid, and which endpoints are they actually allowed to reach. It reads no business data by design. The scope map is the deliverable, and bringing an integration up stops being guesswork.

    Python, Flask, React

    Harness

    • 1 subagent
    • 1 plan
    • Instruction file
  • Year 2026

    Contract Data Validation Chain

    Exported contract data runs through a chain of validators and comes out as a report a person can act on. The chain covers structural integrity, date consistency, financial values and business rules. The domain is modelled as a hierarchy rather than a flat sheet, which is what lets a failure name the exact record instead of the row number.

    Python, FastAPI, pandas, React

    Harness

    • 1 subagent
    • Instruction file
  • Year 2026

    Landing Page and Campaign Forge

    A landing-page builder where a project holds reusable blocks and variable templates. Everything is edited in the app, previewed and published as public pages. A later phase added generated copy and a keyword planner that proposes single-theme ad groups from the project's own context and validates every term against the ads API before exporting the campaign.

    React, Express, Firestore, Gemini

    Harness

    • 96 context docs
    • 5 decision records
    • 7 plans

Three repositories are the same work as a case study, and are listed once, with the case study.

03Built to commission

Built to commission

Commissioned work, described from the brief each one was delivered against.

  • Year 2026

    Lista de Compras

    A Google Sheets extension that builds a shopping list with an LLM and generates matching recipes alongside it.

    JavaScript, HTML, CSS, React, AI

  • Year 2026

    Climbing Training

    A sport-climbing training app that follows a session by altitude, read from the phone's own motion sensors.

    TypeScript, JavaScript, AI

  • Year 2026

    Design System Agent

    An agent for Claude Code that interviews the user about what they want to build. It then generates the whole frontend under a Feature-Sliced Design architecture.

    AI, Claude Code, Feature-Sliced Design

  • Year 2026

    Affiliantes

    A management system for an affiliate programme.

    Python, React, JavaScript, AI

  • Year 2026

    Validador de Documentos

    A document validation system for handling data inconsistencies.

    Python, React, JavaScript, ChatGPT, AI

  • Year 2026

    Validador de Credenciais

    An application that validates API credentials and records them in a secure environment, to automate customer onboarding.

    JavaScript, Python, React, ChatGPT, AI

  • Year 2026

    Portal de Documentação

    A product documentation portal built to simplify understanding of the data, with an FAQ, customer management and an access log.

    Python, JavaScript, React, Firebase, AI

  • Year 2026

    Boardgame Animais

    A companion app that extends the play of a charades board game about guessing which animal it is.

    Python, React, JavaScript, ChatGPT, AI

04Impact campaign

Impact campaign

An awarded campaign that became a government programme.

  • Year 2011

    Esta vaga não é sua nem por um minuto

    An awarded campaign on respect for parking spaces reserved for people with disabilities. It spread across social media, won national advertising prizes and became the Viver sem Limites government programme. The agency TheGetz created it, and Nossa Causa published the movement's guide.

    Social impact, Campaign, Public policy

05Projects