Skip to content

Add repository working guide for brand maintenance - #26

Merged
vitormattos merged 1 commit into
mainfrom
docs/add-agents-guide
Sep 25, 2026
Merged

vitormattos merged 1 commit into
mainfrom
docs/add-agents-guide

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Add a concise AGENTS.md as an operational entry point for humans and automated contributors maintaining the LibreSign brand repository.

The guide intentionally does not duplicate the brand manual or detailed architecture documentation. It points contributors to the canonical files and records the decision-making rules that are easy to lose when someone arrives fresh:

  • source-of-truth hierarchy;
  • where content, components, theme tokens, artwork, legal records, and licensing belong;
  • how to handle normative brand changes;
  • canonical-artwork and deterministic-generation rules;
  • Typst maintenance and exact compiler-version policy;
  • PDF accessibility expectations;
  • immutable GitHub Action pins and Dependabot boundaries;
  • licensing/trademark separation;
  • common workflows for text, artwork, builds, and releases;
  • DCO and review hygiene;
  • stable-release gate after homologation.

The wording is written to be equally usable by a human maintainer or an automated contributor.

Commit includes:

Signed-off-by: Vitor Mattos <vitor@php.rio>

Signed-off-by: Vitor Mattos <vitor@php.rio>
@vitormattos
vitormattos merged commit d1137d8 into main Sep 25, 2026
5 checks passed
@vitormattos
vitormattos deleted the docs/add-agents-guide branch September 25, 2026 18:29
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