日本語

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

PiraGo Security News (security-news.pirago.vn) is an internal security intelligence and reporting website for PiraGo engineering teams and project managers. It hosts monthly vulnerability digests, major incident reports, and emergency response runbooks.

Architecture & Technology Stack

Report Authoring & Publishing Workflow

When creating or modifying security reports, strictly follow monthly/RULES.md:

  1. Create New Monthly Report (3 files):
    • _data/monthly/YYYY-mm.yml: copy from _templates/monthly-data.yml, fill in every text field in both vi and ja.
    • monthly/YYYY-mm.html: copy from _templates/monthly-stub.html (keeps redirect_from).
    • monthly/ja/YYYY-mm.html: copy from _templates/monthly-stub-ja.html (sets lang: ja and permalink: /ja/monthly/YYYY-mm/).
  2. Table & Content Standards:
    • Tables are generated by the include from sections (type: actions | component | provider | list); column labels, the #tableFilterInput filter bar and severity badges (crit|high|med|low, labels from _data/i18n.yml) are rendered automatically.
    • Core technology focus areas:
      • Infrastructure: AWS, GCP
      • Languages & Runtimes: NodeJS, PHP, Java, .NET, JavaScript
      • Frameworks: Next.js, Nuxt, Quasar, Laravel, Spring Boot
      • Browsers & Package Registries: Chrome/V8, npm, Composer, Maven
  3. Cross-File Synchronization: none needed by hand. The header dropdown, footer links and the summary cards on index.html / ja/index.html loop over site.data.monthly (newest first, newest gets the “new” badge). Fill the card block in the data file for the homepage summary.

Fetching Public Sources

If a fetch of a public page returns HTTP 403 Forbidden or requires browser rendering, use an available Playwright or Chrome DevTools tool to open the URL and extract the rendered content. Discover and activate the browser tool if available; if neither is available, use another accessible public source.

Verify that the output contains the expected content, not an error, login, or challenge page. If access is still blocked or requires authentication, use another public source rather than trying to bypass the restriction.

Deployment & Common Commands

Every new vulnerability analysis page (featured/<case>/analysis.html + ja/analysis.html) must include, like the existing pages (e.g. featured/nginx-cve-2026-123007/):

Rules