vanillagreencom/kendex/jarvis

Jarvis

Setup

Use the home layout for the Jarvis home. Its starting files come from jarvis-session init or a person's first manual Start, under Initialize.

The declared agents, cpa, legal, operator, auditor, researcher, scout, reviewer-arch and publicist, require a kendex installation of Jarvis. Copying only the skill folder, including an app-supplied copy, supplies none of their harness agent files. Use the bundle command in README: Install from the Jarvis home. It installs Jarvis with its required skills, declared agents, their assigned skills and the session hooks. Installing orch alone does not install Jarvis or its declared agents.

Read the home contract when starting a session or finding a memory note.

kendex does not insert package text into AGENTS.md. The fixed persona path is persona.md, beside SKILL.md.

Plain folder

On first load, check the folder's AGENTS.md. If no line in it routes to persona.md, offer once, in one line, to add the route line Initialize writes. Add it only after the user agrees. Never paste the persona text into AGENTS.md: the installed file stays its one copy. The route then loads on every turn through the harness's instruction-loading settings. Check that the harness loaded those instructions.

App-managed home

The assistant app gives persona.md to its sessions itself. A line in AGENTS.md that routes to persona.md is the persona step here. Do not offer to paste the persona text into AGENTS.md. The text would load twice.

Reachable repositories

At first load, and when the user asks which repositories Jarvis can reach, judge each folder kendex project list prints, a (worktree of [MAIN]) line by [MAIN]:

• Run the folder's own .agents/skills/mailbox/scripts/lane-mail events --item overseer --box to-overseer with the folder as the working directory. Exit 0 is reachable; a mailbox nobody has written yet prints no envelope at exit 0. This probe records no read position. Read session messages through Agent reach: Read.
• Anything else is unreachable. Its cause is the folder's note, a missing mailbox script, or the key lane-mail printed, such as command-missing python3 or file-unreadable.
• A folder with no mailbox script but with .agents/skills/orch/ has an orch older than the mailbox package. Its cause is "refresh needed", and the offer is kendex refresh in that folder.

Report both lists in one message, each unreachable folder with its cause.

Cleanup and backups

Remove all unused code, files, keys, secret-store entries, databases, records and settings from every holder in the same change.

Back up only if a step can lose the only copy; delete the backup after checking the result.

Reading routes

Read the linked workflow or reference for the task before acting.