Skip to content

docs: add agent knowledge base, cross-repo contract and skills - #173

Merged
MaxDac merged 3 commits into
mainfrom
docs/agent-knowledge-base
Oct 8, 2026
Merged

MaxDac merged 3 commits into
mainfrom
docs/agent-knowledge-base

Conversation

@MaxDac

@MaxDac MaxDac commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

Summary

Externalises the knowledge needed to refactor Privee and coordinate with MaxDac/PriveeApp and its F-Droid releases, for Claude Code and GitHub Copilot.

  • Adds stack/version, architecture and server–Android contract docs, with compatibility, wake-up-only push and libsignal alignment guidance.
  • Adds tool-specific agent instructions and mirrored skills: api-change, local-dev-stack, deploy-privee, libsignal-wasm-upgrade, security-change-review. Preserves the generic Phoenix guidelines in AGENTS.md and links the knowledge base from the README.
  • Adds a CI job checking that .claude/skills and .github/skills are identical; preserves pull-request, push-to-main and manual CI triggers.
  • Merges current main, including Move deployment to PriveeDeploy; Privee runs CI only #174's move to MaxDac/PriveeDeploy. Privee owns source, Dockerfile and CI only; PriveeDeploy owns fly.toml and manual deploy.yml. Removes the superseded deploy skill and uses deploy-privee as the single canonical procedure.
  • Corrects all deployment references and the removed README anchor. Agent deployments require successful CI for the full source SHA and explicit user confirmation. Deploy the server before a dependent app release; rollback requires an explicitly chosen older SHA and database migration compatibility.

Validation

  • All five mirrored skill files are byte-identical.
  • All 110 relative Markdown links/anchors checked across the updated docs and skills resolve.
  • CI YAML parses; pull-request, push-to-main and manual triggers remain intact. No local fly.toml or deployment workflow is reintroduced.
  • Deployment guidance checked against PriveeDeploy's current README, deploy.yml, fly.toml and merged self-hosting documentation.
  • Full CI results are shown in the PR checks. No production deployment is performed.

Massimiliano D'Acunzo and others added 2 commits October 8, 2026 09:15
Add docs/TECHNOLOGIES.md, docs/ARCHITECTURE.md and docs/cross-repo.md
(the shared contract with MaxDac/PriveeApp), CLAUDE.md and
.github/copilot-instructions.md, and five skills mirrored in
.claude/skills and .github/skills (api-change, local-dev-stack, deploy,
libsignal-wasm-upgrade, security-change-review). Prepend a project
section to AGENTS.md, link the docs from the README and add a CI job
that fails when the two skill directories differ.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5ea5781b-c84c-47b9-8f99-781002da3818
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5ea5781b-c84c-47b9-8f99-781002da3818
@MaxDac
MaxDac merged commit 6b5cfee into main Oct 8, 2026
@MaxDac
MaxDac deleted the docs/agent-knowledge-base branch October 8, 2026 12:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant