Skip to content

docs: agent knowledge base, architecture and technology docs, skills - #20

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

Description

Externalises the knowledge needed to refactor PriveeApp and publish on F-Droid:

  • docs/TECHNOLOGIES.md and docs/ARCHITECTURE.md: stack, UnifiedPush notifications, source-built libsignal, runtime wiring and reproducibility-sensitive changes.
  • Separate CLAUDE.md and .github/copilot-instructions.md, with commands, conventions and guardrails.
  • Identical Claude/Copilot skills: libsignal-upgrade, dependency-upgrade, store-screenshots, cross-repo-change, plus updated fdroid-release links.
  • Generalised skill-copy tests covering file sets, contents, front matter and relative links; README entry points.

Companion: MaxDac/Privee#173, which owns the cross-repo contract. Updated after MaxDac/Privee#174: server merges run CI only; production deployment is a separate, explicitly confirmed PriveeDeploy workflow using a full source SHA with successful CI. The cross-repo skill also explains that an API-version bump needs an app-first compatibility migration rather than immediately locking out installed apps.

Validation: python3 -m unittest discover -s scripts/tests passed (158 tests) after the correction; git diff --check passed. The earlier negative test demonstrated that a drifted skill copy fails the comparison check. Android tests/lint/build run in CI.

Checklist

  • No secrets committed (API keys, endpoints, tokens, .jks, .env)
  • :core:* modules contain no android.* / androidx.* imports
  • Tests pass (./gradlew test) — passed in the initial PR CI; reruns for the updated head.
  • Commit messages follow Conventional Commits

Massimiliano D'Acunzo and others added 3 commits October 7, 2026 22:02
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5ea5781b-c84c-47b9-8f99-781002da3818
… skills

Add docs/TECHNOLOGIES.md (full stack breakdown, notifications, native
libsignal) and docs/ARCHITECTURE.md (modules, data flow, where to change
what, reproducibility-sensitive changes).

Add hand-written CLAUDE.md and .github/copilot-instructions.md, and four
skills shipped for both tools: libsignal-upgrade, dependency-upgrade,
store-screenshots and cross-repo-change. Generalise the skill-copy test to
every skill, and check front matter and relative links.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5ea5781b-c84c-47b9-8f99-781002da3818
Document PriveeDeploy ownership, CI and confirmation gates, and staged API-version migration.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5ea5781b-c84c-47b9-8f99-781002da3818
@MaxDac
MaxDac merged commit 483a7da into main Oct 8, 2026
5 checks passed
@MaxDac
MaxDac deleted the docs/agent-knowledge-base branch October 8, 2026 12:31
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