What problem does it solve? Bringing an existing repository or local project into a managed vault workflow is risky: agents may start changing code before anyone understands what the project actually is. This Skill onboards existing projects through read-only reconnaissance, a structured interview, and a mandatory Epoch 1 of organization that blocks any project changes until the knowledge harness is complete. ## Core Features & Use Cases - Read-only codebase recon: Generates a RECON.md via the recon-project script, then launches parallel subagents covering structure, build/test, docs, git history, and fragile spots, consolidated into a short map confirmed by the user. - Vault fit and materialization: Determines project type (uni-repo vs multi-repo), default language, i18n needs, and PR branch, then installs the pop/ harness with pop_install_unirepo.py and creates PROJECT.md and ROADMAP.md. - Organization gate: Adds a rule to the project's AGENTS.md blocking any change to project content until Epoch 1 (Organization) completes; specs are deferred and created only work-driven via write-spec. - Use Case: You have a legacy codebase you want an AI agent to maintain. Run the import so the agent maps the code, builds DOX documentation, skills, and notes first, and only then starts accepting change tasks through the kanban. ## Quick Start Ask the agent to import your existing repository into the PoP vault by providing its URL or local path.
