Security Principles Page Is Dead Link for Security Skill

[prograhamming]

🎟️ Tracking

No tracking. Came up from a conversation in slack in team eng ai channel

📔 Objective

bitwarden-security-context/SKILL.md has a broken page. Fixing this to help the model have access to a security principles link within the skill, but also give a high level summary of each of the principles.

📸 Screenshots

Before:

After:

[cloudflare-workers-and-pages]

Deploying contributing-docs with    Cloudflare Pages

Latest commit:	b665850
Status:	✅  Deploy successful!
Preview URL:	https://8ec10815.contributing-docs.pages.dev
Branch Preview URL:	https://docs-security-principles-ind.contributing-docs.pages.dev

View logs

[github-actions]

🤖 Bitwarden Claude Code Review

Overall Assessment: APPROVE

This PR adds a single new documentation page, docs/architecture/security/principles/index.mdx, which gives the previously page-less principles category a landing page so /architecture/security/principles resolves instead of 404ing. I verified each principle summary against 01- through 06-*.mdx and found the P01-P06 descriptions, the locked-versus-unlocked framing, and the device-compromise mapping accurate to the source pages. Relative links (../requirements.mdx, ../index.mdx#references, and the six extensionless sibling links) match the pattern already used in 03-limited-security-on-semi-compromised.mdx and 04-no-security-on-fully-compromised.mdx, and the build runs with onBrokenLinks: "throw" with a successful Cloudflare Pages deploy on this commit. The page also satisfies the newly adopted documentation standard: explicit audience line, descriptive link text, relative in-repo links, and prose wrapped to the repo's Prettier settings.

Code Review Details

No code findings.

PR Metadata Assessment

• ❓ QUESTION: The Objective section is empty (template comment only); a sentence on why the page was needed would help future readers.

[withinfocus]

The content is in the individual pages though -- we just need an index page that provides links to all sub-pages.

[sognefej]

The content is in the individual pages though -- we just need an index page that provides links to all sub-pages.

I was picturing how we do the ADRs page: https://contributing.bitwarden.com/architecture/adr/#adrs

With maybe keeping the principles section.

[withinfocus]

❓ Why did these move?

[prograhamming]

Reverted — P03 and P04 are back to their original order (byte-identical to main), so this PR is a single new file again.

For context on why they moved: the DocCardList on the new index page excerpts each card description from the page's first block, and on these two pages that is the admonition. Both cards rendered as "This principle applies only to unlocked vaults. Refer to P02 for details" rather than their own principle. That is cosmetic and not worth the churn here — if we want to fix the card text later, a description in the frontmatter does it without touching the prose.

[withinfocus]

⛏️ Drop this section, in case something drifts and it becomes inaccurate given the duplication.

[prograhamming]

Removed this section.