pasiero

pasiero / architecture

One assistant, many doors.

Pasiero should not be defined by one chat app or one interface. The channel changes with the moment; the relationship, personal context, file boundaries, and history remain consistent.

04 · the shape of the product

chat apps        desktop        terminal        mobile        integrations
    \               |               |              |                /
     \              |               |              |               /
      +-------------+---------------+--------------+--------------+
                                    |
                                    v
                         one Pasiero relationship
                                    |
                 preferences · context · boundaries · history
                                    |
                                    v
                     files and folders you choose to share

Channels fit different moments

The best interface depends on the task.

Conversation

A chat or voice channel is useful when you know the outcome but not the path: "find the house insurance and tell me when it renews."

natural requests · follow-up questions

Visual workspace

A desktop or mobile view is better for reviewing photos, comparing duplicates, dragging boundaries, and approving a large organization plan.

browse · compare · preview

Direct tools

A terminal or keyboard-first interface suits quick searches, repeatable routines, and people who already work close to the filesystem.

fast · precise · scriptable by choice

Connected routines

Optional integrations can bring new downloads, scans, camera imports, or shared family folders to Pasiero's attention without making any communication service the product itself.

inbox · import · notification

What remains the same everywhere

The channel is a door, not a new assistant.

  1. 01

    The same personal context

    Pasiero remembers the preferences you chose to keep: where receipts belong, how trips are named, which photo folder contains originals, and what "closed project" means to you.

  2. 02

    The same file boundaries

    Switching from a desktop view to a chat does not expand what Pasiero can access. Scope follows your choices, not the convenience of the interface.

  3. 03

    The same confirmation standard

    Every interface must show what will change and require a deliberate confirmation. Smaller screens do not justify vaguer approvals.

  4. 04

    The same history

    A folder organized from a phone should appear in the same understandable activity history when you return to a desktop.

The personal filesystem at the center

The files remain ordinary files.

Pasiero works with the folders people already recognize. It should add understanding and assistance without turning personal files into a private database that only Pasiero can read. 

Personal Files/
|
|-- Documents/
|   |-- Identity/                 passport scans, certificates
|   |-- Finance/                  taxes, statements, receipts
|   |-- Health/                   records and prescriptions
|   `-- Home/                     lease, insurance, warranties
|
|-- Photos/
|   `-- 2026/
|       `-- Lisbon/               originals, edits, itinerary
|
|-- Projects/
|   |-- Kitchen renovation/
|   `-- Family history/
|
|-- Downloads/                    useful, temporary, or forgotten
`-- Archive/                      finished and worth keeping

The product direction is documented in PRODUCT_DIRECTION.md. Implementation choices can change without changing this relationship with the user and their files.