openpetswithchatandmcp/docs/consolidated_workflows/INDEX.md

FamiliarOS Workflow Integration Index

Last updated: 2026-06-18

Purpose: Canonical home for the FamiliarOS workflow manual assembled from current FamiliarOS reality plus the most reusable operating doctrine already compacted through the recent ScriptoriumAI, HyperTwist, and VectorShell consolidation work.

Canonical Rule

Read the docs under docs/consolidated_workflows/familiaros/ first.

• Those files are the live, FamiliarOS-branded operating surface.
• Donor project names should appear there only in provenance notes.
• The shared/ folder retains generic cross-project doctrine that FamiliarOS now uses directly.

Canonical FamiliarOS Workflow Manual

Canonical Doc	Purpose
familiaros/README.md	Front-door guide for the integrated workflow pack
familiaros/MODEL_A_B_FULL_SEQUENCE_CANON.md	Full generic Model A / Model B sequence set retained in canonical form
familiaros/PROJECT_AUTHORITY_AND_RECONCILIATION.md	Current-source-first truth, donor precedence, and selective backfill rules
familiaros/DESKTOP_COMPANION_AND_FRONT_DOOR_DOCTRINE.md	Canonical product-surface doctrine across desktop companion, control center, website, and agent bridge
familiaros/REPO_EVALUATION_AND_CLEAN_ROOM_PLAYBOOK.md	Repo intake, phased evaluation, donor-fit analysis, and clean-room handling for FamiliarOS
familiaros/LICENSE_CUSTODY_AND_EVIDENCE_WORKFLOW.md	License, custody, asset-rights, and evidence workflow
familiaros/FEATURE_REGISTRY_AND_DEEP_SOURCE_CLOSEOUT.md	Closeout checklist for feature-registry, roadmap, and evidence-surface synchronization
familiaros/IMPLEMENTATION_BATCHING_AND_DISPOSITION.md	FamiliarOS-first batching, anchor handling, and retained-value disposition rules
familiaros/OPERATOR_WORKBENCH_AND_VISUALIZATION_DOCTRINE.md	Control-center, familiar, website, and operator-surface composition doctrine
familiaros/MEMORY_CONTINUITY_AND_ASSISTIVE_OPTIONALITY_DOCTRINE.md	Bounded memory/knowledge/continuity lane rules and assistive optionality doctrine
familiaros/PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE.md	First-party provider-neutral routing and BYOK custody doctrine for FamiliarOS chat, plugin AI, and voice/provider surfaces
familiaros/ARTIFACT_STORAGE_AND_RUNTIME_BOUNDARIES.md	Source-vs-build-vs-backup-vs-archive distinctions and cleanup rules
familiaros/DECISION_GATES_FRONT_DOOR_AND_REMOTE_EXECUTION.md	User decision-gate handling, single-front-door rule, and remote execution boundaries
familiaros/HIGH_IMPORTANCE_TRANSFER_GAP_AUDIT_2026-06-18.md	Compact audit of what broader workflow doctrine was missing and what this follow-up promoted

Shared Workflow Adjuncts

These docs remain project-agnostic and reusable.

Path	Role
shared/BACKFILL_PROCEDURES.md	Cross-project retroactive backfill and correction procedure
shared/CROSS_LANE_AUTHORITY_HIERARCHY.md	Generic A / R / F authority model for overlapping repos and capabilities
shared/LICENSE_TRACKING_WORKFLOW.md	Generic tracker and evidence-audit workflow for repo/license classification
shared/MODEL_A_B_CLEAN_ROOM_PROMPTS.md	Generic clean-room prompt surfaces and role separation support
shared/REPO_EVALUATION_MODUS_OPERANDI.md	Generic repo-evaluation execution baseline

Maintenance Rules

1. Update the FamiliarOS-branded docs before editing upstream provenance notes.
2. Keep FamiliarOS product language in headings, summaries, and decision rules.
3. Use donor names only in provenance sections, source maps, or explicit historical notes.
4. When current FamiliarOS source contradicts donor wording, current FamiliarOS source wins.
5. When a donor-source correction changes live guidance, patch the FamiliarOS canonical doc and then record the source delta.
6. Deep-source closure must also reconcile FEATURE_REGISTRY.md, docs/REPO_LICENSE_TRACKING.md, roadmap notes, and relevant ops/asset-rights docs when applicable.
7. The full generic Model A / Model B sequence set must remain stored in canonical form at docs/consolidated_workflows/familiaros/MODEL_A_B_FULL_SEQUENCE_CANON.md.
8. When a later comparison asks what still remained missing from the front-door pack, refresh the latest high-importance gap audit note rather than leaving that answer implicit.

Source Mapping Summary

Source Family	Main Value Preserved For FamiliarOS
Current FamiliarOS repo	Product truth, desktop runtime, Control Center, plugin platform, memory/knowledge, provider, and ops reality
ScriptoriumAI consolidation pack	Workflow-pack structure, compact doctrine shape, Model A / Model B canonical retention, and closeout discipline
HyperTwist / VectorShell doctrines	Reusable clean-room, authority, decision-gate, remote-execution, batching, artifact, and continuity rules

Status

• familiaros/ is now the canonical workflow home for FamiliarOS.
• The pack no longer stops at the earlier compact mini-layer; it now covers the broader workflow doctrine families the user requested.
• shared/ is retained locally for generic support doctrine.
• Donor-specific product identity remains outside the FamiliarOS front door.