인증된 AgentReady.md 증명서
발급일 sig: b7a86686ca0e2975 검증 →

분석된 URL

https://github.com/y-miyazaki/config

측정: 2개월 전

다른 URL 분석

AI-Ready 점수

미흡

/ 100

토큰 절감량

HTML 토큰 148.307
Markdown 토큰 2042
절감 99%

점수 상세

시맨틱 HTML 56/100
콘텐츠 효율성 48/100
AI 발견 가능성 45/100
구조화 데이터 55/100
접근성 87/100

신흥 프로토콜

6개 중 0개 감지

AI 에이전트가 찾는 well-known 엔드포인트. 감지되면 에이전트가 서비스를 자동으로 발견하고 연결할 수 있습니다.

  • OAuth Protected Resource RFC 9728
    /.well-known/oauth-protected-resource
  • OAuth Discovery RFC 8414
    /.well-known/oauth-authorization-server
  • MCP Server Card SEP-1649 draft
    /.well-known/mcp/server-card.json
  • A2A Agent Card A2A v1.0
    /.well-known/agent-card.json
  • API Catalog RFC 9727
    /.well-known/api-catalog
  • Agent Skills index Discovery RFC v0.2.0 draft
    /.well-known/agent-skills/index.json

이 점수는 그대로 있지 않습니다. 모니터링은 아직 없습니다. 명단에 등록하면 출시할 때 알려드립니다.

명단에 등록되었습니다! 서비스 출시 시 알려드리겠습니다.

측정 결과 Content ratio: 1.5% (5458 content chars / 372557 HTML bytes)

페이지의 실제 콘텐츠와 전체 HTML의 비율이 낮습니다. 페이지 무게의 상당 부분이 콘텐츠가 아닌 마크업, 스크립트, 스타일입니다.

구현 방법

CSS를 외부 스타일시트로 이동하고, 인라인 스타일을 제거하고, JavaScript를 최소화하고, HTML이 콘텐츠 구조에 집중하도록 하세요.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 No Markdown for Agents support detected

사이트가 Markdown for Agents를 지원하지 않습니다. 이 Cloudflare 표준을 통해 AI 에이전트가 마크다운 형식으로 콘텐츠를 요청할 수 있으며, 토큰 사용량을 ~80% 줄일 수 있습니다.

구현 방법

다음 중 하나 이상을 구현하세요: (1) Accept: text/markdown에 마크다운 콘텐츠로 응답. (2) .md URL 제공 (예: /page.md). (3) <link rel="alternate" type="text/markdown"> 태그 추가. (4) 마크다운 발견을 위한 Link HTTP 헤더 추가.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 No sitemap found

사이트맵을 찾을 수 없습니다. 사이트맵은 AI 에이전트가 사이트의 모든 페이지를 발견하는 데 도움을 줍니다.

구현 방법

모든 공개 페이지를 나열하는 /sitemap.xml을 만드세요. 대부분의 CMS 플랫폼에서 자동 생성할 수 있습니다.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 No Content-Signal found (robots.txt or HTTP headers)

Content-Signal 지시어가 발견되지 않았습니다. 이는 AI 에이전트에게 콘텐츠 사용 방법(검색 색인, AI 입력, 훈련 데이터)을 알려줍니다. 권장 위치는 robots.txt입니다.

구현 방법

robots.txt에 Content-Signal을 추가하세요: User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no. 마크다운 응답의 HTTP 헤더로도 추가할 수 있습니다.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 Avg div depth: 17.4, max: 24

페이지에 깊이 중첩된 <div> 요소가 있습니다. 깊은 중첩은 잡음을 추가하고 AI 에이전트의 콘텐츠 추출을 어렵게 합니다.

구현 방법

불필요한 래퍼 div를 제거하여 HTML 구조를 단순화하세요. 중첩 컨테이너 div 대신 CSS Grid 또는 Flexbox를 레이아웃에 사용하세요.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 158/2531 elements with inline styles (6.2%)

많은 요소에 인라인 스타일 속성이 있습니다. 이는 콘텐츠를 추출하는 AI 에이전트에게 잡음이 됩니다.

구현 방법

모든 인라인 스타일을 스타일시트의 CSS 클래스로 이동하세요. 많은 고유 스타일이 필요하면 Tailwind 같은 유틸리티 CSS 프레임워크를 사용하세요.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 No JSON-LD / Schema.org found

Schema.org 구조화 데이터를 찾을 수 없습니다. JSON-LD는 AI 에이전트가 페이지에서 사실 기반의 구조화 정보를 추출하는 데 도움을 줍니다.

구현 방법

Schema.org 마크업이 포함된 <script type="application/ld+json"> 블록을 추가하세요. 적절한 유형을 사용하세요: 블로그 게시물에는 Article, 제품 페이지에는 Product, 회사 페이지에는 Organization.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 9 semantic elements, 606 divs (ratio: 1%)

페이지가 <div> 요소에 크게 의존합니다. <section>, <nav>, <header>, <footer>, <aside> 같은 시맨틱 요소는 AI 에이전트에게 의미 있는 구조를 제공합니다.

구현 방법

범용 <div> 컨테이너를 적절한 시맨틱 요소로 교체하세요. 주제별 그룹에는 <section>, 내비게이션에는 <nav>, 페이지/섹션 헤더와 푸터에는 <header>/<footer>를 사용하세요.

코딩 에이전트에 붙여넣어 수정하게 하세요

측정 결과 No canonical URL

정규 URL을 찾을 수 없습니다. AI 에이전트가 페이지의 선호 버전을 식별하고 중복 콘텐츠를 방지하는 데 도움을 줍니다.

구현 방법

페이지의 정규 URL을 가리키는 <link rel="canonical" href="..."> 태그를 추가하세요.

코딩 에이전트에 붙여넣어 수정하게 하세요
Markdown 토큰: 2042
Shared configuration packages for AI agent tooling, GitHub Actions workflows, and Renovate policy reuse.

This repository is a shared configuration repository. It is focused on practical usage and reuse of settings across projects.

-   Specifications for this repository are documented under [`docs/`](https://github.com/y-miyazaki/config/blob/main/docs), including repository structure in [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md).
-   Usage and installation steps are documented in this `README.md`.
-   AI agent-related configuration files are shared as APM packages.
-   Shared automation is provided through GitHub Actions workflows.
-   Shared dependency update policy is provided through Renovate configuration.

## Table of Contents[](https://github.com/y-miyazaki/config#table-of-contents)

-   [Documentation](https://github.com/y-miyazaki/config#documentation)
-   [APM](https://github.com/y-miyazaki/config#apm)
    -   [Packages](https://github.com/y-miyazaki/config#packages)
    -   [MCP Servers](https://github.com/y-miyazaki/config#mcp-servers)
    -   [Hooks](https://github.com/y-miyazaki/config#hooks)
    -   [Skills](https://github.com/y-miyazaki/config#skills)
    -   [Instructions](https://github.com/y-miyazaki/config#instructions)
    -   [Install](https://github.com/y-miyazaki/config#install)
    -   [Individual packages](https://github.com/y-miyazaki/config#individual-packages)
    -   [Other targets](https://github.com/y-miyazaki/config#other-targets)
    -   [Use in other repositories](https://github.com/y-miyazaki/config#use-in-other-repositories)
-   [GitHub Actions](https://github.com/y-miyazaki/config#github-actions)
    -   [Reuse shared workflows](https://github.com/y-miyazaki/config#reuse-shared-workflows)
-   [Renovate](https://github.com/y-miyazaki/config#renovate)
    -   [Reuse shared policy](https://github.com/y-miyazaki/config#reuse-shared-policy)
-   [License](https://github.com/y-miyazaki/config#license)

## Documentation[](https://github.com/y-miyazaki/config#documentation)

-   Usage: this `README.md`
-   Specification and structure: [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)
-   Documentation index: [`docs/index.md`](https://github.com/y-miyazaki/config/blob/main/docs/index.md)

## APM[](https://github.com/y-miyazaki/config#apm)

APM is used to share AI agent-related configuration files as packages. Each package bundles MCP servers, hooks, instructions, and skills appropriate for its domain.

### Packages[](https://github.com/y-miyazaki/config#packages)

| Package | Description | MCP Servers | Hooks | Instructions | Skills |
| --- | --- | --- | --- | --- | --- |
| common | Shared workflows, documentation, and tools | 6 | 1 | 4 | 7 |
| aws | AWS development | 5 | 0 | 0 | 0 |
| terraform | Terraform development (cloud-agnostic) | 1 | 1 | 1 | 2 |
| terraform-aws | Terraform + AWS integration | 1 | 0 | 0 | 0 |
| go | Go development | 0 | 1 | 1 | 2 |
| shell-script | Shell script development | 0 | 1 | 1 | 2 |

### MCP Servers[](https://github.com/y-miyazaki/config#mcp-servers)

| Package | Server | Description |
| --- | --- | --- |
| common | context7 | Context management |
| common | fetch | HTTP fetch |
| common | github | GitHub Copilot MCP |
| common | codebase-memory-mcp | Codebase memory |
| common | lean-ctx | Lean context management |
| common | playwright | Browser automation |
| aws | aws-mcp | AWS MCP proxy |
| aws | aws-knowledge-mcp-server | AWS knowledge base |
| aws | aws-documentation-mcp-server | AWS documentation |
| aws | aws-pricing-mcp-server | AWS pricing |
| aws | awslabs-aws-api-mcp-server | AWS API operations |
| terraform | hashicorp-terraform-mcp-server | Terraform operations |
| terraform-aws | awslabs-terraform-mcp-server | Terraform AWS provider support |

### Hooks[](https://github.com/y-miyazaki/config#hooks)

| Package | Hook | Trigger | Description |
| --- | --- | --- | --- |
| common | lean-ctx | pre/postTool | Context observation and rewrite/redirect |
| go | golangci-lint | postToolUse | Auto-fix Go files with golangci-lint |
| terraform | terraform-validate-tflint | postToolUse | Run terraform validate and tflint on changed files |
| shell-script | shellcheck | postToolUse | Run shellcheck on changed shell scripts |

### Skills[](https://github.com/y-miyazaki/config#skills)

| Package | Skill | Description |
| --- | --- | --- |
| common | agent-skills-review | Review agent skill definitions |
| common | docs-creation | Create documentation |
| common | github-actions-review | Review GitHub Actions workflows |
| common | github-actions-validation | Validate GitHub Actions workflows |
| common | github-pr-body | Generate PR body |
| common | instructions-review | Review instruction files |
| common | markdown-validation | Validate Markdown files |
| go | go-review | Review Go code |
| go | go-validation | Validate Go code |
| terraform | terraform-review | Review Terraform code |
| terraform | terraform-validation | Validate Terraform code |
| shell-script | shell-script-review | Review shell scripts |
| shell-script | shell-script-validation | Validate shell scripts |

### Instructions[](https://github.com/y-miyazaki/config#instructions)

| Package | Instruction | Scope |
| --- | --- | --- |
| common | agent-skills | Agent skill files |
| common | github-actions-workflow | GitHub Actions workflows |
| common | instructions | Instruction files |
| common | markdown | Markdown files |
| go | go | `**/*.go` |
| terraform | terraform | `**/*.tf`, `**/*.tfvars`, `**/*.hcl` |
| shell-script | shell-script | `**/*.sh` |

### Install[](https://github.com/y-miyazaki/config#install)

Install the full package (all sub-packages):

apm install y-miyazaki/config --target copilot

> **Note:** `--target` is not required if your project already has an `apm.yml` (auto-detected from the `target:` setting).

### Individual packages[](https://github.com/y-miyazaki/config#individual-packages)

# Common (MCP servers + hooks + instructions + skills)
apm install y-miyazaki/config/.apm/packages/common

# AWS (MCP servers only)
apm install y-miyazaki/config/.apm/packages/aws

# Terraform (MCP server + hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/terraform

# Terraform + AWS (MCP server only)
apm install y-miyazaki/config/.apm/packages/terraform-aws

# Go (hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/go

# Shell Script (hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/shell-script

### Other targets[](https://github.com/y-miyazaki/config#other-targets)

# Claude
apm install y-miyazaki/config --target claude

# Cursor
apm install y-miyazaki/config --target cursor

# All targets
apm install y-miyazaki/config --target all

### Use in other repositories[](https://github.com/y-miyazaki/config#use-in-other-repositories)

After adding dependencies to your project's `apm.yml`, teammates only need:

apm install --frozen

This resolves all dependencies from `apm.lock.yaml` and deploys skills, instructions, hooks, and MCP servers to the appropriate target directories.

## GitHub Actions[](https://github.com/y-miyazaki/config#github-actions)

GitHub Actions workflows are shared as reusable workflow definitions in this repository.

### Reuse shared workflows[](https://github.com/y-miyazaki/config#reuse-shared-workflows)

Use this repository's reusable workflows from your repository workflows:

jobs:
  markdown:
    uses: y-miyazaki/config/.github/workflows/ci-markdown.yaml@main

For production usage, pin a commit SHA instead of a branch.

## Renovate[](https://github.com/y-miyazaki/config#renovate)

Renovate configuration is shared as reusable policy presets.

### Reuse shared policy[](https://github.com/y-miyazaki/config#reuse-shared-policy)

Create or update your `.github/renovate.json`:

{
	"extends": \["github>y-miyazaki/config//renovate/default"\]
}

This enables the shared Renovate baseline and policy defaults maintained in this repository.

## License[](https://github.com/y-miyazaki/config#license)

Apache-2.0
GitHub - y-miyazaki/config: A repository of initial settings around the editor · GitHub

[Skip to content](https://github.com/y-miyazaki/config#start-of-content)

## Navigation MenuToggle navigation

[](https://github.com/)

[Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)

Appearance settings

Search or jump to...

# Search code, repositories, users, issues, pull requests...

Search

Clear

[Search syntax tips](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax)

# Provide feedback

We read every piece of feedback, and take your input very seriously.

 Include my email address so I can be contacted

Cancel Submit feedback

# Saved searches## Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our [documentation](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax).

Cancel Create saved search

[Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)

[Sign up](https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=y-miyazaki%2Fconfig)

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

[y-miyazaki](https://github.com/y-miyazaki) / **[config](https://github.com/y-miyazaki/config)** Public

-   [Notifications](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig) You must be signed in to change notification settings
-   [Fork 0](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig)
-   [Star 1](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig)

 [](https://github.com/y-miyazaki/config)

# y-miyazaki/config

 main

[Branches](https://github.com/y-miyazaki/config/branches)[Tags](https://github.com/y-miyazaki/config/tags)

[](https://github.com/y-miyazaki/config/branches)[](https://github.com/y-miyazaki/config/tags)

Go to file

Code

Open more actions menu

## Folders and files

| Name | Name |

Last commit message

 |

Last commit date

 |
| --- | --- | --- | --- |
|

## Latest commit

## History[262 Commits](https://github.com/y-miyazaki/config/commits/main/)

[](https://github.com/y-miyazaki/config/commits/main/)262 Commits

 |
|

[.agents/skills](https://github.com/y-miyazaki/config/tree/main/.agents/skills "This path skips through empty directories")

 |

[.agents/skills](https://github.com/y-miyazaki/config/tree/main/.agents/skills "This path skips through empty directories")

 |

 |

 |
|

[.apm/packages](https://github.com/y-miyazaki/config/tree/main/.apm/packages "This path skips through empty directories")

 |

[.apm/packages](https://github.com/y-miyazaki/config/tree/main/.apm/packages "This path skips through empty directories")

 |

 |

 |
|

[.devcontainer](https://github.com/y-miyazaki/config/tree/main/.devcontainer ".devcontainer")

 |

[.devcontainer](https://github.com/y-miyazaki/config/tree/main/.devcontainer ".devcontainer")

 |

 |

 |
|

[.github](https://github.com/y-miyazaki/config/tree/main/.github ".github")

 |

[.github](https://github.com/y-miyazaki/config/tree/main/.github ".github")

 |

 |

 |
|

[.vscode](https://github.com/y-miyazaki/config/tree/main/.vscode ".vscode")

 |

[.vscode](https://github.com/y-miyazaki/config/tree/main/.vscode ".vscode")

 |

 |

 |
|

[docs](https://github.com/y-miyazaki/config/tree/main/docs "docs")

 |

[docs](https://github.com/y-miyazaki/config/tree/main/docs "docs")

 |

 |

 |
|

[env](https://github.com/y-miyazaki/config/tree/main/env "env")

 |

[env](https://github.com/y-miyazaki/config/tree/main/env "env")

 |

 |

 |
|

[renovate](https://github.com/y-miyazaki/config/tree/main/renovate "renovate")

 |

[renovate](https://github.com/y-miyazaki/config/tree/main/renovate "renovate")

 |

 |

 |
|

[scripts](https://github.com/y-miyazaki/config/tree/main/scripts "scripts")

 |

[scripts](https://github.com/y-miyazaki/config/tree/main/scripts "scripts")

 |

 |

 |
|

[test](https://github.com/y-miyazaki/config/tree/main/test "test")

 |

[test](https://github.com/y-miyazaki/config/tree/main/test "test")

 |

 |

 |
|

[.editorconfig](https://github.com/y-miyazaki/config/blob/main/.editorconfig ".editorconfig")

 |

[.editorconfig](https://github.com/y-miyazaki/config/blob/main/.editorconfig ".editorconfig")

 |

 |

 |
|

[.gitignore](https://github.com/y-miyazaki/config/blob/main/.gitignore ".gitignore")

 |

[.gitignore](https://github.com/y-miyazaki/config/blob/main/.gitignore ".gitignore")

 |

 |

 |
|

[.gitleaks.toml](https://github.com/y-miyazaki/config/blob/main/.gitleaks.toml ".gitleaks.toml")

 |

[.gitleaks.toml](https://github.com/y-miyazaki/config/blob/main/.gitleaks.toml ".gitleaks.toml")

 |

 |

 |
|

[.golangci.yaml](https://github.com/y-miyazaki/config/blob/main/.golangci.yaml ".golangci.yaml")

 |

[.golangci.yaml](https://github.com/y-miyazaki/config/blob/main/.golangci.yaml ".golangci.yaml")

 |

 |

 |
|

[.markdownlint.yaml](https://github.com/y-miyazaki/config/blob/main/.markdownlint.yaml ".markdownlint.yaml")

 |

[.markdownlint.yaml](https://github.com/y-miyazaki/config/blob/main/.markdownlint.yaml ".markdownlint.yaml")

 |

 |

 |
|

[.markdownlintignore](https://github.com/y-miyazaki/config/blob/main/.markdownlintignore ".markdownlintignore")

 |

[.markdownlintignore](https://github.com/y-miyazaki/config/blob/main/.markdownlintignore ".markdownlintignore")

 |

 |

 |
|

[.pre-commit-config-go.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-go.yaml ".pre-commit-config-go.yaml")

 |

[.pre-commit-config-go.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-go.yaml ".pre-commit-config-go.yaml")

 |

 |

 |
|

[.pre-commit-config-sql-mysql.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-sql-mysql.yaml ".pre-commit-config-sql-mysql.yaml")

 |

[.pre-commit-config-sql-mysql.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-sql-mysql.yaml ".pre-commit-config-sql-mysql.yaml")

 |

 |

 |
|

[.pre-commit-config-terraform.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-terraform.yaml ".pre-commit-config-terraform.yaml")

 |

[.pre-commit-config-terraform.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-terraform.yaml ".pre-commit-config-terraform.yaml")

 |

 |

 |
|

[.pre-commit-config.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config.yaml ".pre-commit-config.yaml")

 |

[.pre-commit-config.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config.yaml ".pre-commit-config.yaml")

 |

 |

 |
|

[.textlintrc.json](https://github.com/y-miyazaki/config/blob/main/.textlintrc.json ".textlintrc.json")

 |

[.textlintrc.json](https://github.com/y-miyazaki/config/blob/main/.textlintrc.json ".textlintrc.json")

 |

 |

 |
|

[AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md "AGENTS.md")

 |

[AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md "AGENTS.md")

 |

 |

 |
|

[README.md](https://github.com/y-miyazaki/config/blob/main/README.md "README.md")

 |

[README.md](https://github.com/y-miyazaki/config/blob/main/README.md "README.md")

 |

 |

 |
|

[SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md "SECURITY.md")

 |

[SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md "SECURITY.md")

 |

 |

 |
|

[apm.lock.yaml](https://github.com/y-miyazaki/config/blob/main/apm.lock.yaml "apm.lock.yaml")

 |

[apm.lock.yaml](https://github.com/y-miyazaki/config/blob/main/apm.lock.yaml "apm.lock.yaml")

 |

 |

 |
|

[apm.yml](https://github.com/y-miyazaki/config/blob/main/apm.yml "apm.yml")

 |

[apm.yml](https://github.com/y-miyazaki/config/blob/main/apm.yml "apm.yml")

 |

 |

 |
|

[aqua-checksums.json](https://github.com/y-miyazaki/config/blob/main/aqua-checksums.json "aqua-checksums.json")

 |

[aqua-checksums.json](https://github.com/y-miyazaki/config/blob/main/aqua-checksums.json "aqua-checksums.json")

 |

 |

 |
|

[aqua-policy.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-policy.yaml "aqua-policy.yaml")

 |

[aqua-policy.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-policy.yaml "aqua-policy.yaml")

 |

 |

 |
|

[aqua-registry.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-registry.yaml "aqua-registry.yaml")

 |

[aqua-registry.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-registry.yaml "aqua-registry.yaml")

 |

 |

 |
|

[aqua.yaml](https://github.com/y-miyazaki/config/blob/main/aqua.yaml "aqua.yaml")

 |

[aqua.yaml](https://github.com/y-miyazaki/config/blob/main/aqua.yaml "aqua.yaml")

 |

 |

 |
|

[trivy.yaml](https://github.com/y-miyazaki/config/blob/main/trivy.yaml "trivy.yaml")

 |

[trivy.yaml](https://github.com/y-miyazaki/config/blob/main/trivy.yaml "trivy.yaml")

 |

 |

 |
|

View all files

 |

## Repository files navigation

# y-miyazaki/config[](https://github.com/y-miyazaki/config#y-miyazakiconfig)

Shared configuration packages for AI agent tooling, GitHub Actions workflows, and Renovate policy reuse.

This repository is a shared configuration repository. It is focused on practical usage and reuse of settings across projects.

-   Specifications for this repository are documented under [`docs/`](https://github.com/y-miyazaki/config/blob/main/docs), including repository structure in [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md).
-   Usage and installation steps are documented in this `README.md`.
-   AI agent-related configuration files are shared as APM packages.
-   Shared automation is provided through GitHub Actions workflows.
-   Shared dependency update policy is provided through Renovate configuration.

## Table of Contents[](https://github.com/y-miyazaki/config#table-of-contents)

-   [Documentation](https://github.com/y-miyazaki/config#documentation)
-   [APM](https://github.com/y-miyazaki/config#apm)
    -   [Packages](https://github.com/y-miyazaki/config#packages)
    -   [MCP Servers](https://github.com/y-miyazaki/config#mcp-servers)
    -   [Hooks](https://github.com/y-miyazaki/config#hooks)
    -   [Skills](https://github.com/y-miyazaki/config#skills)
    -   [Instructions](https://github.com/y-miyazaki/config#instructions)
    -   [Install](https://github.com/y-miyazaki/config#install)
    -   [Individual packages](https://github.com/y-miyazaki/config#individual-packages)
    -   [Other targets](https://github.com/y-miyazaki/config#other-targets)
    -   [Use in other repositories](https://github.com/y-miyazaki/config#use-in-other-repositories)
-   [GitHub Actions](https://github.com/y-miyazaki/config#github-actions)
    -   [Reuse shared workflows](https://github.com/y-miyazaki/config#reuse-shared-workflows)
-   [Renovate](https://github.com/y-miyazaki/config#renovate)
    -   [Reuse shared policy](https://github.com/y-miyazaki/config#reuse-shared-policy)
-   [License](https://github.com/y-miyazaki/config#license)

## Documentation[](https://github.com/y-miyazaki/config#documentation)

-   Usage: this `README.md`
-   Specification and structure: [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)
-   Documentation index: [`docs/index.md`](https://github.com/y-miyazaki/config/blob/main/docs/index.md)

## APM[](https://github.com/y-miyazaki/config#apm)

APM is used to share AI agent-related configuration files as packages. Each package bundles MCP servers, hooks, instructions, and skills appropriate for its domain.

### Packages[](https://github.com/y-miyazaki/config#packages)

| Package | Description | MCP Servers | Hooks | Instructions | Skills |
| --- | --- | --- | --- | --- | --- |
| common | Shared workflows, documentation, and tools | 6 | 1 | 4 | 7 |
| aws | AWS development | 5 | 0 | 0 | 0 |
| terraform | Terraform development (cloud-agnostic) | 1 | 1 | 1 | 2 |
| terraform-aws | Terraform + AWS integration | 1 | 0 | 0 | 0 |
| go | Go development | 0 | 1 | 1 | 2 |
| shell-script | Shell script development | 0 | 1 | 1 | 2 |

### MCP Servers[](https://github.com/y-miyazaki/config#mcp-servers)

| Package | Server | Description |
| --- | --- | --- |
| common | context7 | Context management |
| common | fetch | HTTP fetch |
| common | github | GitHub Copilot MCP |
| common | codebase-memory-mcp | Codebase memory |
| common | lean-ctx | Lean context management |
| common | playwright | Browser automation |
| aws | aws-mcp | AWS MCP proxy |
| aws | aws-knowledge-mcp-server | AWS knowledge base |
| aws | aws-documentation-mcp-server | AWS documentation |
| aws | aws-pricing-mcp-server | AWS pricing |
| aws | awslabs-aws-api-mcp-server | AWS API operations |
| terraform | hashicorp-terraform-mcp-server | Terraform operations |
| terraform-aws | awslabs-terraform-mcp-server | Terraform AWS provider support |

### Hooks[](https://github.com/y-miyazaki/config#hooks)

| Package | Hook | Trigger | Description |
| --- | --- | --- | --- |
| common | lean-ctx | pre/postTool | Context observation and rewrite/redirect |
| go | golangci-lint | postToolUse | Auto-fix Go files with golangci-lint |
| terraform | terraform-validate-tflint | postToolUse | Run terraform validate and tflint on changed files |
| shell-script | shellcheck | postToolUse | Run shellcheck on changed shell scripts |

### Skills[](https://github.com/y-miyazaki/config#skills)

| Package | Skill | Description |
| --- | --- | --- |
| common | agent-skills-review | Review agent skill definitions |
| common | docs-creation | Create documentation |
| common | github-actions-review | Review GitHub Actions workflows |
| common | github-actions-validation | Validate GitHub Actions workflows |
| common | github-pr-body | Generate PR body |
| common | instructions-review | Review instruction files |
| common | markdown-validation | Validate Markdown files |
| go | go-review | Review Go code |
| go | go-validation | Validate Go code |
| terraform | terraform-review | Review Terraform code |
| terraform | terraform-validation | Validate Terraform code |
| shell-script | shell-script-review | Review shell scripts |
| shell-script | shell-script-validation | Validate shell scripts |

### Instructions[](https://github.com/y-miyazaki/config#instructions)

| Package | Instruction | Scope |
| --- | --- | --- |
| common | agent-skills | Agent skill files |
| common | github-actions-workflow | GitHub Actions workflows |
| common | instructions | Instruction files |
| common | markdown | Markdown files |
| go | go | `**/*.go` |
| terraform | terraform | `**/*.tf`, `**/*.tfvars`, `**/*.hcl` |
| shell-script | shell-script | `**/*.sh` |

### Install[](https://github.com/y-miyazaki/config#install)

Install the full package (all sub-packages):

```shell
apm install y-miyazaki/config --target copilot
```

> **Note:** `--target` is not required if your project already has an `apm.yml` (auto-detected from the `target:` setting).

### Individual packages[](https://github.com/y-miyazaki/config#individual-packages)

```shell
# Common (MCP servers + hooks + instructions + skills)
apm install y-miyazaki/config/.apm/packages/common

# AWS (MCP servers only)
apm install y-miyazaki/config/.apm/packages/aws

# Terraform (MCP server + hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/terraform

# Terraform + AWS (MCP server only)
apm install y-miyazaki/config/.apm/packages/terraform-aws

# Go (hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/go

# Shell Script (hook + instruction + skills)
apm install y-miyazaki/config/.apm/packages/shell-script
```

### Other targets[](https://github.com/y-miyazaki/config#other-targets)

```shell
# Claude
apm install y-miyazaki/config --target claude

# Cursor
apm install y-miyazaki/config --target cursor

# All targets
apm install y-miyazaki/config --target all
```

### Use in other repositories[](https://github.com/y-miyazaki/config#use-in-other-repositories)

After adding dependencies to your project's `apm.yml`, teammates only need:

```shell
apm install --frozen
```

This resolves all dependencies from `apm.lock.yaml` and deploys skills, instructions, hooks, and MCP servers to the appropriate target directories.

## GitHub Actions[](https://github.com/y-miyazaki/config#github-actions)

GitHub Actions workflows are shared as reusable workflow definitions in this repository.

### Reuse shared workflows[](https://github.com/y-miyazaki/config#reuse-shared-workflows)

Use this repository's reusable workflows from your repository workflows:

```yaml
jobs:
  markdown:
    uses: y-miyazaki/config/.github/workflows/ci-markdown.yaml@main
```

For production usage, pin a commit SHA instead of a branch.

## Renovate[](https://github.com/y-miyazaki/config#renovate)

Renovate configuration is shared as reusable policy presets.

### Reuse shared policy[](https://github.com/y-miyazaki/config#reuse-shared-policy)

Create or update your `.github/renovate.json`:

```json
{
	"extends": ["github>y-miyazaki/config//renovate/default"]
}
```

This enables the shared Renovate baseline and policy defaults maintained in this repository.

## License[](https://github.com/y-miyazaki/config#license)

Apache-2.0

## About

A repository of initial settings around the editor

### Topics

[config](https://github.com/topics/config "Topic: config")

### Resources

[Readme](https://github.com/y-miyazaki/config#readme-ov-file)

### Security policy

[Security policy](https://github.com/y-miyazaki/config#security-ov-file)

### Uh oh!

There was an error while loading. Please reload this page.

[Activity](https://github.com/y-miyazaki/config/activity)

### Stars

[**1** star](https://github.com/y-miyazaki/config/stargazers)

### Watchers

[**1** watching](https://github.com/y-miyazaki/config/watchers)

### Forks

[**0** forks](https://github.com/y-miyazaki/config/forks)

[Report repository](https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig&report=y-miyazaki+%28user%29)

## [Releases 22](https://github.com/y-miyazaki/config/releases)[

v1.1.12 Latest

May 21, 2026

](https://github.com/y-miyazaki/config/releases/tag/v1.1.12)

[\+ 21 releases](https://github.com/y-miyazaki/config/releases)

## [Packages 0](https://github.com/users/y-miyazaki/packages?repo_name=config)

### Uh oh!

There was an error while loading. Please reload this page.

## [Contributors](https://github.com/y-miyazaki/config/graphs/contributors)

### Uh oh!

There was an error while loading. Please reload this page.

## Languages

-   [Shell 98.3%](https://github.com/y-miyazaki/config/search?l=shell)
-   [HTML 1.4%](https://github.com/y-miyazaki/config/search?l=html)
-   Other 0.3%

You can’t perform that action at this time.

이 파일을 서버의 /y-miyazaki/config.md에 업로드하여 AI 에이전트가 페이지의 깔끔한 버전에 접근할 수 있게 하세요. Accept: text/markdown 콘텐츠 협상을 설정하여 자동으로 제공할 수도 있습니다.

권장 내용

llms.txt 다운로드
# GitHub

> A repository of initial settings around the editor - y-miyazaki/config

## Documentation
- [docs](https://github.com/y-miyazaki/config/tree/main/docs)
- [AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md)
- [README.md](https://github.com/y-miyazaki/config/blob/main/README.md)
- [SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md)
- [docs/](https://github.com/y-miyazaki/config/blob/main/docs)
- [docs/specification.md](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)
- [docs/index.md](https://github.com/y-miyazaki/config/blob/main/docs/index.md)

## Main
- [GitHub - y-miyazaki/config: A repository of initial settings around the editor](https://github.com/y-miyazaki/config): A repository of initial settings around the editor - y-miyazaki/config
- [GitHub CopilotWrite better code with AI](https://github.com/features/copilot)
- [GitHub SparkBuild and deploy intelligent apps](https://github.com/features/spark)
- [GitHub ModelsManage and compare prompts](https://github.com/features/models)
- [ActionsAutomate any workflow](https://github.com/features/actions)
- [CodespacesInstant dev environments](https://github.com/features/codespaces)
- [IssuesPlan and track work](https://github.com/features/issues)
- [Code ReviewManage code changes](https://github.com/features/code-review)
- [View all features](https://github.com/features)
- [Small and medium teams](https://github.com/team)
- [Nonprofits](https://github.com/solutions/industry/nonprofits)
- [App Modernization](https://github.com/solutions/use-case/app-modernization)
- [DevSecOps](https://github.com/solutions/use-case/devsecops)
- [DevOps](https://github.com/solutions/use-case/devops)
- [CI/CD](https://github.com/solutions/use-case/ci-cd)
- [View all use cases](https://github.com/solutions/use-case)
- [Healthcare](https://github.com/solutions/industry/healthcare)
- [Financial services](https://github.com/solutions/industry/financial-services)
- [Manufacturing](https://github.com/solutions/industry/manufacturing)
- [Government](https://github.com/solutions/industry/government)
- [View all industries](https://github.com/solutions/industry)
- [View all solutions](https://github.com/solutions)
- [Business insights](https://github.com/solutions/executive-insights)
- [Copilot for BusinessEnterprise-grade AI features](https://github.com/features/copilot/copilot-business)
- [Pricing](https://github.com/pricing)
- [Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)
- [MCP RegistryNewIntegrate external tools](https://github.com/mcp)
- [GitHub Advanced SecurityFind and fix vulnerabilities](https://github.com/security/advanced-security)
- [Code securitySecure your code as you build](https://github.com/security/advanced-security/code-security)
- [Secret protectionStop leaks before they start](https://github.com/security/advanced-security/secret-protection)
- [Why GitHub](https://github.com/why-github)
- [Marketplace](https://github.com/marketplace)
- [Enterprises](https://github.com/enterprise)

## Blog
- [AI](https://github.com/resources/articles?topic=ai)
- [Software Development](https://github.com/resources/articles?topic=software-development)
- [DevOps](https://github.com/resources/articles?topic=devops)
- [Security](https://github.com/resources/articles?topic=security)
- [View all topics](https://github.com/resources/articles)

전체 llms.txt는 도메인 전체 분석이 필요합니다 (곧 출시)

이 파일을 도메인 루트의 https://github.com/llms.txt에 업로드하세요. ChatGPT, Claude, Perplexity 등의 AI 에이전트가 이 파일을 확인하여 사이트 구조를 파악합니다.

이 사이트에는 이미 llms.txt 파일이 있습니다.

유효한 형식
# GitHub

> GitHub is a developer platform for building, shipping, and maintaining software. It provides cloud-based Git repository hosting, CI/CD via GitHub Actions, project management with Issues and Projects, code review via pull requests, AI-powered development with GitHub Copilot, and APIs (REST and GraphQL) for automation and integration.

## How to use

To retrieve full article content, page lists, or search results programmatically, please use the APIs below. To find a specific article, use the **Search API** with a query. To browse all available pages, use the **Page List API** to get a list of paths, then fetch individual articles with the **Article API**. The `/api/article/body` endpoint returns markdown, ideal for LLM consumption. These APIs return structured markdown and JSON and are the preferred way for LLMs and automated tools to access GitHub documentation.

* [Versions API](https://docs.github.com/api/pagelist/versions): Lists all available documentation versions.
* [Languages API](https://docs.github.com/api/pagelist/languages): Lists all available languages.
* [Page List API](https://docs.github.com/api/pagelist/en/free-pro-team@latest): Returns every docs page path for a given language and version.
* [Article API](https://docs.github.com/api/article): Returns the full rendered content and context of any docs page as JSON. Example: `curl "https://docs.github.com/api/article?pathname=/en/get-started/start-your-journey/about-github-and-git"`
* [Article Body API](https://docs.github.com/api/article/body): Returns the full rendered content of any docs page as markdown. Example: `curl "https://docs.github.com/api/article/body?pathname=/en/get-started/start-your-journey/about-github-and-git"`
* [Search API](https://docs.github.com/api/search/v1): Search across all docs content. Example: `curl "https://docs.github.com/api/search/v1?query=actions&language=en&version=free-pro-team@latest"`
* [GitHub MCP server](https://github.com/github/github-mcp-server): For agents that connect via Model Context Protocol, the GitHub MCP server provides tools for working with GitHub itself: repositories, issues, pull requests, workflows, and code. It does not currently include docs search.

## Building with GitHub, for coding agents and automation

* [Extend Copilot Chat with MCP](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp): Connect MCP servers to Copilot Chat to share context from other applications.
* [Use the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/use-the-github-mcp-server): Learn how to use the GitHub Model Context Protocol (MCP) server to interact with repositories, issues, pull requests, and other GitHub features, directly from Copilot Chat in your IDE.
* [Set up the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/set-up-the-github-mcp-server): Learn how to configure the GitHub Model Context Protocol (MCP) server.
* [About cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent): Copilot can research a repository, create an implementation plan, and make code changes on a branch. You can review the diff, iterate, and create a pull request when you're ready.
* [Create custom agents in your IDE](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents-in-your-ide): You can create specialized agents with tailored expertise for specific development tasks.
* [GitHub CLI](https://docs.github.com/en/github-cli/github-cli): GitHub CLI is an open source tool for using GitHub from your computer's command line. When you're working from the command line, you can use the GitHub CLI to save time and avoid switching context.
* [Quickstart](https://docs.github.com/en/github-cli/github-cli/quickstart): Start using GitHub CLI to work with GitHub in the command line.
* [REST API](https://docs.github.com/en/rest): Create integrations, retrieve data, and automate your workflows with the GitHub REST API.
* [GraphQL API](https://docs.github.com/en/graphql): To create integrations, retrieve data, and automate your workflows, use the GitHub GraphQL API. The GitHub GraphQL API offers more precise and flexible queries than the GitHub REST API.
* [GitHub Actions](https://docs.github.com/en/actions): Automate, customize, and execute your software development workflows right in your repository with GitHub Actions. You can discover, create, and share actions to perform any job you'd like, including CI/CD, and combine actions in a completely customized workflow.

## GitHub Copilot

> You can use GitHub Copilot to enhance your productivity and assist as you work on code.

* [GitHub Copilot](https://docs.github.com/en/copilot): You can use GitHub Copilot to enhance your productivity and assist as you work on code.
* [Copilot requests](https://docs.github.com/en/copilot/concepts/billing/copilot-requests): Learn about requests in Copilot, including premium requests, how they work, and how to manage your usage effectively.
* [Individual plans](https://docs.github.com/en/copilot/concepts/billing/individual-plans): GitHub offers several Copilot plans for individual developers, each with different features, model access, and usage limits to support a wide range of coding needs.
* [Usage-based billing for individuals](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals): Your Copilot plan will include a monthly allowance of GitHub AI Credits. If you exhaust your AI credits, you can pay extra to keep working.
* [Usage-based billing for organizations and enterprises](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises): Prepare for the transition to usage-based billing for Copilot Business and Copilot Enterprise.
* [Usage limits](https://docs.github.com/en/copilot/concepts/usage-limits): Learn about GitHub Copilot usage limits and what to do if you hit a limit.
* [Features](https://docs.github.com/en/copilot/get-started/features): GitHub Copilot offers a suite of features for users and administrators.
* [Plans](https://docs.github.com/en/copilot/get-started/plans): Learn about the available plans for Copilot.
* [Quickstart](https://docs.github.com/en/copilot/get-started/quickstart): Quickly learn how to use GitHub Copilot.
* [What is GitHub Copilot?](https://docs.github.com/en/copilot/get-started/what-is-github-copilot): Learn what Copilot is and what you can do with it.
* [Copilot CLI best practices](https://docs.github.com/en/copilot/how-tos/copilot-cli/cli-best-practices): Learn how to get the most out of GitHub Copilot CLI.
* [Install Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli): Learn how to install Copilot CLI so that you can use Copilot directly from the command line.
* [Overview](https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli/overview): Learn how to use GitHub Copilot from the command line.
* [Add repository instructions](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions): Create repository custom instructions files that give Copilot additional context on how to understand your project and how to build, test and validate its changes.
* [Set up for students](https://docs.github.com/en/copilot/how-tos/copilot-on-github/set-up-copilot/enable-copilot/set-up-for-students): Get free access to Copilot's premium features as a verified student.
* [Get IDE code suggestions](https://docs.github.com/en/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions): Use GitHub Copilot to get code suggestions in your editor.
* [Preparing for usage-based billing](https://docs.github.com/en/copilot/how-tos/manage-and-track-spending/prepare-for-your-move-to-usage-based-billing): If you're on a Copilot Pro or Copilot Pro+ plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.
* [Troubleshoot common issues](https://docs.github.com/en/copilot/how-tos/troubleshoot-copilot/troubleshoot-common-issues): This guide describes the most common issues with GitHub Copilot and how to resolve them.
* [Use code review](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review): Learn how to request a code review from GitHub Copilot.
* [Supported models](https://docs.github.com/en/copilot/reference/ai-models/supported-models): Learn about the supported AI models in GitHub Copilot.
* [Model multipliers for annual plans](https://docs.github.com/en/copilot/reference/copilot-billing/model-multipliers-for-annual-plans): After June 1, 2026, model multipliers will change for Copilot Pro and Copilot Pro+ subscribers staying on annual plans under request-based billing.
* [Models and pricing](https://docs.github.com/en/copilot/reference/copilot-billing/models-and-pricing): See per-token pricing for the models available in GitHub Copilot and reference rates for additional usage across plans.
* [Chat in GitHub Mobile](https://docs.github.com/en/copilot/responsible-use/chat-in-github-mobile): Learn how to use GitHub Copilot Chat responsibly by understanding its purposes, capabilities, and limitations.
* [Copilot in GitHub Desktop](https://docs.github.com/en/copilot/responsible-use/copilot-in-github-desktop): Learn how to use Copilot in GitHub Desktop responsibly by understanding its purposes, capabilities, and limitations.
* [GitHub Copilot Chat Cookbook](https://docs.github.com/en/copilot/tutorials/copilot-chat-cookbook): Find examples of prompts to use with GitHub Copilot Chat.
* [Document code](https://docs.github.com/en/copilot/tutorials/copilot-chat-cookbook/document-code): Discover ways that you can use GitHub Copilot Chat to document your code.

## Get started

> Learn how to start building, shipping, and maintaining software with GitHub. Explore our products, sign up for an account, and connect with the world's largest development community.

* [Get started](https://docs.github.com/en/get-started): Learn how to start building, shipping, and maintaining software with GitHub. Explore our products, sign up for an account, and connect with the world's largest development community.
* [About remote repositories](https://docs.github.com/en/get-started/git-basics/about-remote-repositories): GitHub's collaborative approach to development depends on publishing commits from your local repository to GitHub for other people to view, fetch, and update.
* [Ignoring files](https://docs.github.com/en/get-started/git-basics/ignoring-files): You can configure Git to ignore files you don't want to check in to GitHub.
* [Manage remote repositories](https://docs.github.com/en/get-started/git-basics/managing-remote-repositories): Learn to work with your local repositories on your computer and remote repositories hosted on GitHub.
* [Set up Git](https://docs.github.com/en/get-started/git-basics/set-up-git): At the heart of GitHub is an open-source version control system (VCS) called Git. Git is responsible for everything GitHub-related that happens locally on your computer.
* [GitHub's plans](https://docs.github.com/en/get-started/learning-about-github/githubs-plans): An overview of GitHub's pricing plans.
* [Types of GitHub accounts](https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts): Accounts on GitHub allow you to organize and control access to code.
* [Start your journey](https://docs.github.com/en/get-started/start-your-journey): Brand new to GitHub? Learn the basics here.
* [About GitHub and Git](https://docs.github.com/en/get-started/start-your-journey/about-github-and-git): You can use GitHub and Git to collaborate on work.
* [Create an account](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github): Create a personal account to get started with GitHub.
* [Download files](https://docs.github.com/en/get-started/start-your-journey/downloading-files-from-github): Learn how to download files from GitHub, and understand the difference between downloading, cloning, and forking.
* [Hello World](https://docs.github.com/en/get-started/start-your-journey/hello-world): Follow this Hello World exercise to learn GitHub's pull request workflow.
* [Connectivity problems](https://docs.github.com/en/get-started/using-github/troubleshooting-connectivity-problems): If you're having trouble connecting to GitHub, you can troubleshoot your connection, then use the GitHub Debug tool to diagnose problems.
* [Basic formatting syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax): Create sophisticated formatting for your prose and code on GitHub with simple syntax.

## Authentication

> Authenticate securely to GitHub with passwords, tokens, SSH keys, and more—and keep your account protected.

* [Connect with SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh): You can connect to GitHub using the Secure Shell Protocol (SSH), which provides a secure channel over an unsecured network.
* [Add a new SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account): To configure your account on GitHub.com to use your new (or existing) SSH key, you'll also need to add the key to your account.
* [Check for existing SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys): Before you generate an SSH key, you can check to see if you have any existing SSH keys.
* [Generate new SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent): After you've checked for existing SSH keys, you can generate a new SSH key to use for authentication, then add it to the ssh-agent.
* [Test your SSH connection](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection): After you've set up your SSH key and added it to GitHub, you can test your connection.
* [Authentication to GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/about-authentication-to-github): You can securely access your account's resources by authenticating to GitHub, using different credentials depending on where you authenticate.
* [Manage personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens): You can use a personal access token in place of a password when authenticating to GitHub in the command line or with the API.
* [Displaying verification for all commits](https://docs.github.com/en/authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits): You can enable vigilant mode for commit signature verification to mark all of your commits and tags with a signature verification status.
* [Configure 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication): You can choose among multiple options to add a second source of authentication to your account.
* [Configure 2FA recovery](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods): You can set up a variety of recovery methods to access your account if you lose your two-factor authentication credentials.
* [Recover an account with 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials): If you lose access to your two-factor authentication credentials, you can use your recovery codes, or another recovery option, to regain access to your account.

## Account and profile

> Make GitHub work best for you by customizing your personal account settings and personalizing your profile page.

* [Account and profile](https://docs.github.com/en/account-and-profile): Make GitHub work best for you by customizing your personal account settings and personalizing your profile page.
* [Username changes](https://docs.github.com/en/account-and-profile/concepts/username-changes): You can change the username for your GitHub account.
* [Account](https://docs.github.com/en/account-and-profile/get-started/account): Get started with your GitHub account.
* [How-tos](https://docs.github.com/en/account-and-profile/how-tos): Learn how to accomplish specific tasks for your GitHub account and profile.
* [Manage cookie preferences](https://docs.github.com/en/account-and-profile/how-tos/account-settings/manage-cookie-preferences): You can control how GitHub uses information from non-essential tracking cookies for enterprise marketing pages.
* [Troubleshoot missing contributions](https://docs.github.com/en/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions): Learn common reasons that contributions may be missing from your contributions graph.
* [Primary email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/changing-your-primary-email-address): To change your primary email address, you'll add a new email, then delete the old one.
* [Set commit email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address): You can set the email address that is used to author commits on GitHub and on your computer.
* [Verify your email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/verifying-your-email-address): Verifying your primary email address ensures strengthened security, allows GitHub staff to better assist you if you forget your password, and gives you access to more features on GitHub.
* [Personalize your profile](https://docs.github.com/en/account-and-profile/tutorials/personalize-your-profile): You can share information about yourself with other users by setting a profile picture and adding a bio to your profile.

## GitHub Pages

> GitHub Pages turns any GitHub repository into a live website—no separate hosting required.

* [GitHub Pages](https://docs.github.com/en/pages): GitHub Pages turns any GitHub repository into a live website—no separate hosting required.
* [Configure a custom domain](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site): You can customize the domain name of your GitHub Pages site.
* [Custom domains in GitHub Pages](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages): GitHub Pages supports using custom domains, or changing the root of your site's URL from the default, like octocat.github.io, to any domain you own.
* [Manage a custom domain](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site): You can set up or update certain DNS records and your repository settings to point the default domain for your GitHub Pages site to a custom domain.
* [Configure publishing source](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site): You can configure your GitHub Pages site to publish when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.
* [Create a GitHub Pages site](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site): You can create a GitHub Pages site in a new or existing repository.
* [What is GitHub Pages?](https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages): You can use GitHub Pages to host a website about yourself, your organization, or your project directly from a repository on GitHub.
* [Quickstart](https://docs.github.com/en/pages/quickstart): You can use GitHub Pages to showcase some open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.
* [Add theme to Pages site](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll): You can personalize your Jekyll site by adding and customizing a theme.

## Repositories

> Learn to use and manage the repositories that allow you to store and collaborate on your project's code.

* [About rulesets](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets): Rulesets help you to control how people can interact with branches and tags in a repository.
* [Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository): When you create a repository on GitHub, it exists as a remote repository. You can clone your repository to create a local copy on your computer and sync between the two locations.
* [Quickstart for repositories](https://docs.github.com/en/repositories/creating-and-managing-repositories/quickstart-for-repositories): Learn how to create a new repository and commit your first change in 5 minutes.
* [About READMEs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes): You can add a README file to your repository to tell other people why your project is useful, what they can do with your project, and how they can use it.
* [Licensing a repository](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository): Public repositories on GitHub are often used to share open source software. For your repository to truly be open source, you'll need to license it so that others are free to use, change, and distribute the software.
* [About releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases): You can create a release to package software, along with release notes and links to binary files, for other people to use.

## GitHub Actions

> Automate, customize, and execute your software development workflows right in your repository with GitHub Actions. You can discover, create, and share actions to perform any job you'd like, including CI/CD, and combine actions in a completely customized workflow.

* [Quickstart](https://docs.github.com/en/actions/get-started/quickstart): Try out the core features of GitHub Actions in minutes.
* [Understand GitHub Actions](https://docs.github.com/en/actions/get-started/understand-github-actions): Learn the basics of core concepts and essential terminology in GitHub Actions.
* [Workflow syntax](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax): A workflow is a configurable automated process made up of one or more jobs. You must create a YAML file to define your workflow configuration.

## Apps

> Go deeper with GitHub by integrating with our APIs and webhooks, customizing your GitHub workflow, and building and sharing apps with the community.

* [About creating apps](https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps): GitHub Apps let you build integrations to automate processes and extend GitHub's functionality.
* [Authorizing OAuth apps](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps): You can connect your GitHub identity to third-party applications using OAuth. When authorizing an OAuth app, you should ensure you trust the application, review who it's developed by, and review the kinds of information the application wants to access.
* [Authorize](https://docs.github.com/en/apps/using-github-apps/authorizing-github-apps): You can authorize a GitHub App to retrieve information about your GitHub account and to make changes on your behalf.

## Pull requests

> Learn how to use pull requests to suggest changes to a project, receive suggested changes to your own projects, and address issues in pull requests, such as merge conflicts.

* [Compare branches](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests): Pull requests display diffs to compare the changes you made in your topic branch against the base branch that you want to merge your changes into.
* [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests): Pull requests let you propose, review, and merge code changes.
* [Fork a repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo): A fork is a new repository that shares code and visibility settings with the original upstream repository.

## More pages

* [GitHub Actions](https://docs.github.com/en/billing/concepts/product-billing/github-actions): Learn how usage of GitHub Actions is measured against your free allowance and how to pay for additional use.
* [GitHub Models](https://docs.github.com/en/billing/concepts/product-billing/github-models): If you want to use GitHub Models beyond the free usage included in your account, you can choose to opt in to paid usage.
* [Configure security updates](https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/secure-your-dependencies/configuring-dependabot-security-updates): You can use Dependabot security updates or manual pull requests to easily update vulnerable dependencies.
* [Codespaces](https://docs.github.com/en/codespaces): Create a codespace to start developing in a secure, configurable, and dedicated development environment that works how and where you want it to.
* [Installation](https://docs.github.com/en/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop): You can install GitHub Desktop on supported Windows or macOS operating systems.
* [Participate in discussion](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion): You can converse with the community and maintainers in a forum within the repository for a project on GitHub.
* [Prototype with AI models](https://docs.github.com/en/github-models/use-github-models/prototyping-with-ai-models): Find and experiment with AI models for free.
* [About Projects](https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects): Projects is an adaptable, flexible tool for planning and tracking work on GitHub.
* [About GitHub Importer](https://docs.github.com/en/migrations/importing-source-code/using-github-importer/about-github-importer): If your source code is stored on another Git-based hosting service, you can move the code to GitHub.com using GitHub Importer.
* [OAuth app restrictions](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/about-oauth-app-access-restrictions): Organizations can choose which OAuth apps have access to their repositories and other resources by enabling OAuth app access restrictions.
* [Container registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry): You can store and manage Docker and OCI images in the Container registry.
* [Authenticating](https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api): You can authenticate to the REST API to access more endpoints and have a higher rate limit.
* [Permissions for fine-grained PATs](https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens): For each permission granted to a fine-grained personal access token, these are the REST API endpoints that the app can use.
* [Code search syntax](https://docs.github.com/en/search-github/github-code-search/understanding-github-code-search-syntax): You can build search queries for the results you want with specialized code qualifiers, regular expressions, and boolean operations.
* [Disable webhooks](https://docs.github.com/en/webhooks/using-webhooks/disabling-webhooks): You can disable a webhook to unsubscribe from events that occur on GitHub.

<!-- This file is automatically generated. Do not edit manually. -->

시맨틱 HTML

article 또는 main 요소 사용 (100/100)

Has both <article> and <main>

올바른 제목 계층 구조 (80/100)

5 <h1> elements (should be 1)

시맨틱 HTML 요소 사용 (5/100)

9 semantic elements, 606 divs (ratio: 1%)

의미 있는 이미지 alt 속성 (100/100)

No images found

낮은 div 중첩 깊이 (0/100)

Avg div depth: 17.4, max: 24

콘텐츠 효율성

양호한 토큰 감소율 (100/100)

99% token reduction (HTML→Markdown)

양호한 콘텐츠 대 잡음 비율 (0/100)

Content ratio: 1.5% (5458 content chars / 372557 HTML bytes)

최소한의 인라인 스타일 (0/100)

158/2531 elements with inline styles (6.2%)

적절한 페이지 무게 (50/100)

HTML size: 364KB

AI 발견 가능성

llms.txt 파일 있음 (100/100)

llms.txt exists and is valid

robots.txt 파일 있음 (100/100)

robots.txt exists

robots.txt가 AI 봇 허용 (100/100)

All major AI bots allowed

sitemap.xml 있음 (0/100)

No sitemap found

Markdown for Agents 지원 (0/100)
&#10007; Accept: text/markdown &#10007; .md URL &#10007; <link> tag &#10007; Link header
Content-Signal 있음 (robots.txt 또는 HTTP 헤더) (0/100)
&#10003; robots.txt &#10003; HTTP header &#10007; Policy

구조화 데이터

Schema.org / JSON-LD 있음 (0/100)

No JSON-LD / Schema.org found

Open Graph 태그 있음 (100/100)

All OG tags present

메타 설명 있음 (100/100)

Meta description: 70 chars

정규 URL 있음 (0/100)

No canonical URL

lang 속성 있음 (100/100)

lang="en"

접근성

JavaScript 없이 콘텐츠 이용 가능 (100/100)

Content available without JavaScript

적절한 페이지 크기 (80/100)

Page size: 364KB

HTML에서 콘텐츠가 빠른 위치에 배치 (75/100)

Main content starts at 28% of HTML

{
  "url": "https://github.com/y-miyazaki/config",
  "timestamp": 1779373452163,
  "fetch": {
    "mode": "simple",
    "timeMs": 1062,
    "htmlSizeBytes": 372557,
    "supportsMarkdown": false,
    "markdownAgents": {
      "contentNegotiation": false,
      "mdUrl": {
        "found": false,
        "url": null
      },
      "linkTag": {
        "found": false,
        "url": null
      },
      "linkHeader": {
        "found": false,
        "url": null
      },
      "responseHeaders": {
        "contentSignal": null,
        "xMarkdownTokens": null,
        "vary": null
      },
      "frontmatter": {
        "present": false,
        "fields": [],
        "level": "none"
      },
      "level": "none"
    },
    "statusCode": 200
  },
  "extraction": {
    "title": "GitHub - y-miyazaki/config: A repository of initial settings around the editor",
    "excerpt": "A repository of initial settings around the editor - y-miyazaki/config",
    "byline": null,
    "siteName": "GitHub",
    "lang": "en",
    "contentLength": 5458,
    "metadata": {
      "description": "A repository of initial settings around the editor - y-miyazaki/config",
      "ogTitle": "GitHub - y-miyazaki/config: A repository of initial settings around the editor",
      "ogDescription": "A repository of initial settings around the editor - y-miyazaki/config",
      "ogImage": "https://opengraph.githubassets.com/9f5e195a7d406841c95067d76fa1f354b5a7a7ca9a0e07ae400553e1068390e9/y-miyazaki/config",
      "ogType": "object",
      "canonical": null,
      "lang": "en",
      "schemas": [],
      "robotsMeta": null,
      "author": null,
      "generator": null,
      "markdownAlternateHref": null
    }
  },
  "markdown": "Shared configuration packages for AI agent tooling, GitHub Actions workflows, and Renovate policy reuse.\n\nThis repository is a shared configuration repository. It is focused on practical usage and reuse of settings across projects.\n\n-   Specifications for this repository are documented under [`docs/`](https://github.com/y-miyazaki/config/blob/main/docs), including repository structure in [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md).\n-   Usage and installation steps are documented in this `README.md`.\n-   AI agent-related configuration files are shared as APM packages.\n-   Shared automation is provided through GitHub Actions workflows.\n-   Shared dependency update policy is provided through Renovate configuration.\n\n## Table of Contents[](https://github.com/y-miyazaki/config#table-of-contents)\n\n-   [Documentation](https://github.com/y-miyazaki/config#documentation)\n-   [APM](https://github.com/y-miyazaki/config#apm)\n    -   [Packages](https://github.com/y-miyazaki/config#packages)\n    -   [MCP Servers](https://github.com/y-miyazaki/config#mcp-servers)\n    -   [Hooks](https://github.com/y-miyazaki/config#hooks)\n    -   [Skills](https://github.com/y-miyazaki/config#skills)\n    -   [Instructions](https://github.com/y-miyazaki/config#instructions)\n    -   [Install](https://github.com/y-miyazaki/config#install)\n    -   [Individual packages](https://github.com/y-miyazaki/config#individual-packages)\n    -   [Other targets](https://github.com/y-miyazaki/config#other-targets)\n    -   [Use in other repositories](https://github.com/y-miyazaki/config#use-in-other-repositories)\n-   [GitHub Actions](https://github.com/y-miyazaki/config#github-actions)\n    -   [Reuse shared workflows](https://github.com/y-miyazaki/config#reuse-shared-workflows)\n-   [Renovate](https://github.com/y-miyazaki/config#renovate)\n    -   [Reuse shared policy](https://github.com/y-miyazaki/config#reuse-shared-policy)\n-   [License](https://github.com/y-miyazaki/config#license)\n\n## Documentation[](https://github.com/y-miyazaki/config#documentation)\n\n-   Usage: this `README.md`\n-   Specification and structure: [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)\n-   Documentation index: [`docs/index.md`](https://github.com/y-miyazaki/config/blob/main/docs/index.md)\n\n## APM[](https://github.com/y-miyazaki/config#apm)\n\nAPM is used to share AI agent-related configuration files as packages. Each package bundles MCP servers, hooks, instructions, and skills appropriate for its domain.\n\n### Packages[](https://github.com/y-miyazaki/config#packages)\n\n| Package | Description | MCP Servers | Hooks | Instructions | Skills |\n| --- | --- | --- | --- | --- | --- |\n| common | Shared workflows, documentation, and tools | 6 | 1 | 4 | 7 |\n| aws | AWS development | 5 | 0 | 0 | 0 |\n| terraform | Terraform development (cloud-agnostic) | 1 | 1 | 1 | 2 |\n| terraform-aws | Terraform + AWS integration | 1 | 0 | 0 | 0 |\n| go | Go development | 0 | 1 | 1 | 2 |\n| shell-script | Shell script development | 0 | 1 | 1 | 2 |\n\n### MCP Servers[](https://github.com/y-miyazaki/config#mcp-servers)\n\n| Package | Server | Description |\n| --- | --- | --- |\n| common | context7 | Context management |\n| common | fetch | HTTP fetch |\n| common | github | GitHub Copilot MCP |\n| common | codebase-memory-mcp | Codebase memory |\n| common | lean-ctx | Lean context management |\n| common | playwright | Browser automation |\n| aws | aws-mcp | AWS MCP proxy |\n| aws | aws-knowledge-mcp-server | AWS knowledge base |\n| aws | aws-documentation-mcp-server | AWS documentation |\n| aws | aws-pricing-mcp-server | AWS pricing |\n| aws | awslabs-aws-api-mcp-server | AWS API operations |\n| terraform | hashicorp-terraform-mcp-server | Terraform operations |\n| terraform-aws | awslabs-terraform-mcp-server | Terraform AWS provider support |\n\n### Hooks[](https://github.com/y-miyazaki/config#hooks)\n\n| Package | Hook | Trigger | Description |\n| --- | --- | --- | --- |\n| common | lean-ctx | pre/postTool | Context observation and rewrite/redirect |\n| go | golangci-lint | postToolUse | Auto-fix Go files with golangci-lint |\n| terraform | terraform-validate-tflint | postToolUse | Run terraform validate and tflint on changed files |\n| shell-script | shellcheck | postToolUse | Run shellcheck on changed shell scripts |\n\n### Skills[](https://github.com/y-miyazaki/config#skills)\n\n| Package | Skill | Description |\n| --- | --- | --- |\n| common | agent-skills-review | Review agent skill definitions |\n| common | docs-creation | Create documentation |\n| common | github-actions-review | Review GitHub Actions workflows |\n| common | github-actions-validation | Validate GitHub Actions workflows |\n| common | github-pr-body | Generate PR body |\n| common | instructions-review | Review instruction files |\n| common | markdown-validation | Validate Markdown files |\n| go | go-review | Review Go code |\n| go | go-validation | Validate Go code |\n| terraform | terraform-review | Review Terraform code |\n| terraform | terraform-validation | Validate Terraform code |\n| shell-script | shell-script-review | Review shell scripts |\n| shell-script | shell-script-validation | Validate shell scripts |\n\n### Instructions[](https://github.com/y-miyazaki/config#instructions)\n\n| Package | Instruction | Scope |\n| --- | --- | --- |\n| common | agent-skills | Agent skill files |\n| common | github-actions-workflow | GitHub Actions workflows |\n| common | instructions | Instruction files |\n| common | markdown | Markdown files |\n| go | go | `**/*.go` |\n| terraform | terraform | `**/*.tf`, `**/*.tfvars`, `**/*.hcl` |\n| shell-script | shell-script | `**/*.sh` |\n\n### Install[](https://github.com/y-miyazaki/config#install)\n\nInstall the full package (all sub-packages):\n\napm install y-miyazaki/config --target copilot\n\n> **Note:** `--target` is not required if your project already has an `apm.yml` (auto-detected from the `target:` setting).\n\n### Individual packages[](https://github.com/y-miyazaki/config#individual-packages)\n\n# Common (MCP servers + hooks + instructions + skills)\napm install y-miyazaki/config/.apm/packages/common\n\n# AWS (MCP servers only)\napm install y-miyazaki/config/.apm/packages/aws\n\n# Terraform (MCP server + hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/terraform\n\n# Terraform + AWS (MCP server only)\napm install y-miyazaki/config/.apm/packages/terraform-aws\n\n# Go (hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/go\n\n# Shell Script (hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/shell-script\n\n### Other targets[](https://github.com/y-miyazaki/config#other-targets)\n\n# Claude\napm install y-miyazaki/config --target claude\n\n# Cursor\napm install y-miyazaki/config --target cursor\n\n# All targets\napm install y-miyazaki/config --target all\n\n### Use in other repositories[](https://github.com/y-miyazaki/config#use-in-other-repositories)\n\nAfter adding dependencies to your project's `apm.yml`, teammates only need:\n\napm install --frozen\n\nThis resolves all dependencies from `apm.lock.yaml` and deploys skills, instructions, hooks, and MCP servers to the appropriate target directories.\n\n## GitHub Actions[](https://github.com/y-miyazaki/config#github-actions)\n\nGitHub Actions workflows are shared as reusable workflow definitions in this repository.\n\n### Reuse shared workflows[](https://github.com/y-miyazaki/config#reuse-shared-workflows)\n\nUse this repository's reusable workflows from your repository workflows:\n\njobs:\n  markdown:\n    uses: y-miyazaki/config/.github/workflows/ci-markdown.yaml@main\n\nFor production usage, pin a commit SHA instead of a branch.\n\n## Renovate[](https://github.com/y-miyazaki/config#renovate)\n\nRenovate configuration is shared as reusable policy presets.\n\n### Reuse shared policy[](https://github.com/y-miyazaki/config#reuse-shared-policy)\n\nCreate or update your `.github/renovate.json`:\n\n{\n\t\"extends\": \\[\"github>y-miyazaki/config//renovate/default\"\\]\n}\n\nThis enables the shared Renovate baseline and policy defaults maintained in this repository.\n\n## License[](https://github.com/y-miyazaki/config#license)\n\nApache-2.0\n",
  "fullPageMarkdown": "GitHub - y-miyazaki/config: A repository of initial settings around the editor · GitHub\n\n[Skip to content](https://github.com/y-miyazaki/config#start-of-content)\n\n## Navigation MenuToggle navigation\n\n[](https://github.com/)\n\n[Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)\n\nAppearance settings\n\nSearch or jump to...\n\n# Search code, repositories, users, issues, pull requests...\n\nSearch\n\nClear\n\n[Search syntax tips](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax)\n\n# Provide feedback\n\nWe read every piece of feedback, and take your input very seriously.\n\n Include my email address so I can be contacted\n\nCancel Submit feedback\n\n# Saved searches## Use saved searches to filter your results more quickly\n\nName\n\nQuery\n\nTo see all available qualifiers, see our [documentation](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax).\n\nCancel Create saved search\n\n[Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)\n\n[Sign up](https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=y-miyazaki%2Fconfig)\n\nAppearance settings\n\nResetting focus\n\nYou signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert\n\n[y-miyazaki](https://github.com/y-miyazaki) / **[config](https://github.com/y-miyazaki/config)** Public\n\n-   [Notifications](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig) You must be signed in to change notification settings\n-   [Fork 0](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig)\n-   [Star 1](https://github.com/login?return_to=%2Fy-miyazaki%2Fconfig)\n\n [](https://github.com/y-miyazaki/config)\n\n# y-miyazaki/config\n\n main\n\n[Branches](https://github.com/y-miyazaki/config/branches)[Tags](https://github.com/y-miyazaki/config/tags)\n\n[](https://github.com/y-miyazaki/config/branches)[](https://github.com/y-miyazaki/config/tags)\n\nGo to file\n\nCode\n\nOpen more actions menu\n\n## Folders and files\n\n| Name | Name |\n\nLast commit message\n\n |\n\nLast commit date\n\n |\n| --- | --- | --- | --- |\n|\n\n## Latest commit\n\n## History[262 Commits](https://github.com/y-miyazaki/config/commits/main/)\n\n[](https://github.com/y-miyazaki/config/commits/main/)262 Commits\n\n |\n|\n\n[.agents/skills](https://github.com/y-miyazaki/config/tree/main/.agents/skills \"This path skips through empty directories\")\n\n |\n\n[.agents/skills](https://github.com/y-miyazaki/config/tree/main/.agents/skills \"This path skips through empty directories\")\n\n |\n\n |\n\n |\n|\n\n[.apm/packages](https://github.com/y-miyazaki/config/tree/main/.apm/packages \"This path skips through empty directories\")\n\n |\n\n[.apm/packages](https://github.com/y-miyazaki/config/tree/main/.apm/packages \"This path skips through empty directories\")\n\n |\n\n |\n\n |\n|\n\n[.devcontainer](https://github.com/y-miyazaki/config/tree/main/.devcontainer \".devcontainer\")\n\n |\n\n[.devcontainer](https://github.com/y-miyazaki/config/tree/main/.devcontainer \".devcontainer\")\n\n |\n\n |\n\n |\n|\n\n[.github](https://github.com/y-miyazaki/config/tree/main/.github \".github\")\n\n |\n\n[.github](https://github.com/y-miyazaki/config/tree/main/.github \".github\")\n\n |\n\n |\n\n |\n|\n\n[.vscode](https://github.com/y-miyazaki/config/tree/main/.vscode \".vscode\")\n\n |\n\n[.vscode](https://github.com/y-miyazaki/config/tree/main/.vscode \".vscode\")\n\n |\n\n |\n\n |\n|\n\n[docs](https://github.com/y-miyazaki/config/tree/main/docs \"docs\")\n\n |\n\n[docs](https://github.com/y-miyazaki/config/tree/main/docs \"docs\")\n\n |\n\n |\n\n |\n|\n\n[env](https://github.com/y-miyazaki/config/tree/main/env \"env\")\n\n |\n\n[env](https://github.com/y-miyazaki/config/tree/main/env \"env\")\n\n |\n\n |\n\n |\n|\n\n[renovate](https://github.com/y-miyazaki/config/tree/main/renovate \"renovate\")\n\n |\n\n[renovate](https://github.com/y-miyazaki/config/tree/main/renovate \"renovate\")\n\n |\n\n |\n\n |\n|\n\n[scripts](https://github.com/y-miyazaki/config/tree/main/scripts \"scripts\")\n\n |\n\n[scripts](https://github.com/y-miyazaki/config/tree/main/scripts \"scripts\")\n\n |\n\n |\n\n |\n|\n\n[test](https://github.com/y-miyazaki/config/tree/main/test \"test\")\n\n |\n\n[test](https://github.com/y-miyazaki/config/tree/main/test \"test\")\n\n |\n\n |\n\n |\n|\n\n[.editorconfig](https://github.com/y-miyazaki/config/blob/main/.editorconfig \".editorconfig\")\n\n |\n\n[.editorconfig](https://github.com/y-miyazaki/config/blob/main/.editorconfig \".editorconfig\")\n\n |\n\n |\n\n |\n|\n\n[.gitignore](https://github.com/y-miyazaki/config/blob/main/.gitignore \".gitignore\")\n\n |\n\n[.gitignore](https://github.com/y-miyazaki/config/blob/main/.gitignore \".gitignore\")\n\n |\n\n |\n\n |\n|\n\n[.gitleaks.toml](https://github.com/y-miyazaki/config/blob/main/.gitleaks.toml \".gitleaks.toml\")\n\n |\n\n[.gitleaks.toml](https://github.com/y-miyazaki/config/blob/main/.gitleaks.toml \".gitleaks.toml\")\n\n |\n\n |\n\n |\n|\n\n[.golangci.yaml](https://github.com/y-miyazaki/config/blob/main/.golangci.yaml \".golangci.yaml\")\n\n |\n\n[.golangci.yaml](https://github.com/y-miyazaki/config/blob/main/.golangci.yaml \".golangci.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.markdownlint.yaml](https://github.com/y-miyazaki/config/blob/main/.markdownlint.yaml \".markdownlint.yaml\")\n\n |\n\n[.markdownlint.yaml](https://github.com/y-miyazaki/config/blob/main/.markdownlint.yaml \".markdownlint.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.markdownlintignore](https://github.com/y-miyazaki/config/blob/main/.markdownlintignore \".markdownlintignore\")\n\n |\n\n[.markdownlintignore](https://github.com/y-miyazaki/config/blob/main/.markdownlintignore \".markdownlintignore\")\n\n |\n\n |\n\n |\n|\n\n[.pre-commit-config-go.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-go.yaml \".pre-commit-config-go.yaml\")\n\n |\n\n[.pre-commit-config-go.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-go.yaml \".pre-commit-config-go.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.pre-commit-config-sql-mysql.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-sql-mysql.yaml \".pre-commit-config-sql-mysql.yaml\")\n\n |\n\n[.pre-commit-config-sql-mysql.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-sql-mysql.yaml \".pre-commit-config-sql-mysql.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.pre-commit-config-terraform.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-terraform.yaml \".pre-commit-config-terraform.yaml\")\n\n |\n\n[.pre-commit-config-terraform.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config-terraform.yaml \".pre-commit-config-terraform.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.pre-commit-config.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config.yaml \".pre-commit-config.yaml\")\n\n |\n\n[.pre-commit-config.yaml](https://github.com/y-miyazaki/config/blob/main/.pre-commit-config.yaml \".pre-commit-config.yaml\")\n\n |\n\n |\n\n |\n|\n\n[.textlintrc.json](https://github.com/y-miyazaki/config/blob/main/.textlintrc.json \".textlintrc.json\")\n\n |\n\n[.textlintrc.json](https://github.com/y-miyazaki/config/blob/main/.textlintrc.json \".textlintrc.json\")\n\n |\n\n |\n\n |\n|\n\n[AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md \"AGENTS.md\")\n\n |\n\n[AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md \"AGENTS.md\")\n\n |\n\n |\n\n |\n|\n\n[README.md](https://github.com/y-miyazaki/config/blob/main/README.md \"README.md\")\n\n |\n\n[README.md](https://github.com/y-miyazaki/config/blob/main/README.md \"README.md\")\n\n |\n\n |\n\n |\n|\n\n[SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md \"SECURITY.md\")\n\n |\n\n[SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md \"SECURITY.md\")\n\n |\n\n |\n\n |\n|\n\n[apm.lock.yaml](https://github.com/y-miyazaki/config/blob/main/apm.lock.yaml \"apm.lock.yaml\")\n\n |\n\n[apm.lock.yaml](https://github.com/y-miyazaki/config/blob/main/apm.lock.yaml \"apm.lock.yaml\")\n\n |\n\n |\n\n |\n|\n\n[apm.yml](https://github.com/y-miyazaki/config/blob/main/apm.yml \"apm.yml\")\n\n |\n\n[apm.yml](https://github.com/y-miyazaki/config/blob/main/apm.yml \"apm.yml\")\n\n |\n\n |\n\n |\n|\n\n[aqua-checksums.json](https://github.com/y-miyazaki/config/blob/main/aqua-checksums.json \"aqua-checksums.json\")\n\n |\n\n[aqua-checksums.json](https://github.com/y-miyazaki/config/blob/main/aqua-checksums.json \"aqua-checksums.json\")\n\n |\n\n |\n\n |\n|\n\n[aqua-policy.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-policy.yaml \"aqua-policy.yaml\")\n\n |\n\n[aqua-policy.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-policy.yaml \"aqua-policy.yaml\")\n\n |\n\n |\n\n |\n|\n\n[aqua-registry.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-registry.yaml \"aqua-registry.yaml\")\n\n |\n\n[aqua-registry.yaml](https://github.com/y-miyazaki/config/blob/main/aqua-registry.yaml \"aqua-registry.yaml\")\n\n |\n\n |\n\n |\n|\n\n[aqua.yaml](https://github.com/y-miyazaki/config/blob/main/aqua.yaml \"aqua.yaml\")\n\n |\n\n[aqua.yaml](https://github.com/y-miyazaki/config/blob/main/aqua.yaml \"aqua.yaml\")\n\n |\n\n |\n\n |\n|\n\n[trivy.yaml](https://github.com/y-miyazaki/config/blob/main/trivy.yaml \"trivy.yaml\")\n\n |\n\n[trivy.yaml](https://github.com/y-miyazaki/config/blob/main/trivy.yaml \"trivy.yaml\")\n\n |\n\n |\n\n |\n|\n\nView all files\n\n |\n\n## Repository files navigation\n\n# y-miyazaki/config[](https://github.com/y-miyazaki/config#y-miyazakiconfig)\n\nShared configuration packages for AI agent tooling, GitHub Actions workflows, and Renovate policy reuse.\n\nThis repository is a shared configuration repository. It is focused on practical usage and reuse of settings across projects.\n\n-   Specifications for this repository are documented under [`docs/`](https://github.com/y-miyazaki/config/blob/main/docs), including repository structure in [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md).\n-   Usage and installation steps are documented in this `README.md`.\n-   AI agent-related configuration files are shared as APM packages.\n-   Shared automation is provided through GitHub Actions workflows.\n-   Shared dependency update policy is provided through Renovate configuration.\n\n## Table of Contents[](https://github.com/y-miyazaki/config#table-of-contents)\n\n-   [Documentation](https://github.com/y-miyazaki/config#documentation)\n-   [APM](https://github.com/y-miyazaki/config#apm)\n    -   [Packages](https://github.com/y-miyazaki/config#packages)\n    -   [MCP Servers](https://github.com/y-miyazaki/config#mcp-servers)\n    -   [Hooks](https://github.com/y-miyazaki/config#hooks)\n    -   [Skills](https://github.com/y-miyazaki/config#skills)\n    -   [Instructions](https://github.com/y-miyazaki/config#instructions)\n    -   [Install](https://github.com/y-miyazaki/config#install)\n    -   [Individual packages](https://github.com/y-miyazaki/config#individual-packages)\n    -   [Other targets](https://github.com/y-miyazaki/config#other-targets)\n    -   [Use in other repositories](https://github.com/y-miyazaki/config#use-in-other-repositories)\n-   [GitHub Actions](https://github.com/y-miyazaki/config#github-actions)\n    -   [Reuse shared workflows](https://github.com/y-miyazaki/config#reuse-shared-workflows)\n-   [Renovate](https://github.com/y-miyazaki/config#renovate)\n    -   [Reuse shared policy](https://github.com/y-miyazaki/config#reuse-shared-policy)\n-   [License](https://github.com/y-miyazaki/config#license)\n\n## Documentation[](https://github.com/y-miyazaki/config#documentation)\n\n-   Usage: this `README.md`\n-   Specification and structure: [`docs/specification.md`](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)\n-   Documentation index: [`docs/index.md`](https://github.com/y-miyazaki/config/blob/main/docs/index.md)\n\n## APM[](https://github.com/y-miyazaki/config#apm)\n\nAPM is used to share AI agent-related configuration files as packages. Each package bundles MCP servers, hooks, instructions, and skills appropriate for its domain.\n\n### Packages[](https://github.com/y-miyazaki/config#packages)\n\n| Package | Description | MCP Servers | Hooks | Instructions | Skills |\n| --- | --- | --- | --- | --- | --- |\n| common | Shared workflows, documentation, and tools | 6 | 1 | 4 | 7 |\n| aws | AWS development | 5 | 0 | 0 | 0 |\n| terraform | Terraform development (cloud-agnostic) | 1 | 1 | 1 | 2 |\n| terraform-aws | Terraform + AWS integration | 1 | 0 | 0 | 0 |\n| go | Go development | 0 | 1 | 1 | 2 |\n| shell-script | Shell script development | 0 | 1 | 1 | 2 |\n\n### MCP Servers[](https://github.com/y-miyazaki/config#mcp-servers)\n\n| Package | Server | Description |\n| --- | --- | --- |\n| common | context7 | Context management |\n| common | fetch | HTTP fetch |\n| common | github | GitHub Copilot MCP |\n| common | codebase-memory-mcp | Codebase memory |\n| common | lean-ctx | Lean context management |\n| common | playwright | Browser automation |\n| aws | aws-mcp | AWS MCP proxy |\n| aws | aws-knowledge-mcp-server | AWS knowledge base |\n| aws | aws-documentation-mcp-server | AWS documentation |\n| aws | aws-pricing-mcp-server | AWS pricing |\n| aws | awslabs-aws-api-mcp-server | AWS API operations |\n| terraform | hashicorp-terraform-mcp-server | Terraform operations |\n| terraform-aws | awslabs-terraform-mcp-server | Terraform AWS provider support |\n\n### Hooks[](https://github.com/y-miyazaki/config#hooks)\n\n| Package | Hook | Trigger | Description |\n| --- | --- | --- | --- |\n| common | lean-ctx | pre/postTool | Context observation and rewrite/redirect |\n| go | golangci-lint | postToolUse | Auto-fix Go files with golangci-lint |\n| terraform | terraform-validate-tflint | postToolUse | Run terraform validate and tflint on changed files |\n| shell-script | shellcheck | postToolUse | Run shellcheck on changed shell scripts |\n\n### Skills[](https://github.com/y-miyazaki/config#skills)\n\n| Package | Skill | Description |\n| --- | --- | --- |\n| common | agent-skills-review | Review agent skill definitions |\n| common | docs-creation | Create documentation |\n| common | github-actions-review | Review GitHub Actions workflows |\n| common | github-actions-validation | Validate GitHub Actions workflows |\n| common | github-pr-body | Generate PR body |\n| common | instructions-review | Review instruction files |\n| common | markdown-validation | Validate Markdown files |\n| go | go-review | Review Go code |\n| go | go-validation | Validate Go code |\n| terraform | terraform-review | Review Terraform code |\n| terraform | terraform-validation | Validate Terraform code |\n| shell-script | shell-script-review | Review shell scripts |\n| shell-script | shell-script-validation | Validate shell scripts |\n\n### Instructions[](https://github.com/y-miyazaki/config#instructions)\n\n| Package | Instruction | Scope |\n| --- | --- | --- |\n| common | agent-skills | Agent skill files |\n| common | github-actions-workflow | GitHub Actions workflows |\n| common | instructions | Instruction files |\n| common | markdown | Markdown files |\n| go | go | `**/*.go` |\n| terraform | terraform | `**/*.tf`, `**/*.tfvars`, `**/*.hcl` |\n| shell-script | shell-script | `**/*.sh` |\n\n### Install[](https://github.com/y-miyazaki/config#install)\n\nInstall the full package (all sub-packages):\n\n```shell\napm install y-miyazaki/config --target copilot\n```\n\n> **Note:** `--target` is not required if your project already has an `apm.yml` (auto-detected from the `target:` setting).\n\n### Individual packages[](https://github.com/y-miyazaki/config#individual-packages)\n\n```shell\n# Common (MCP servers + hooks + instructions + skills)\napm install y-miyazaki/config/.apm/packages/common\n\n# AWS (MCP servers only)\napm install y-miyazaki/config/.apm/packages/aws\n\n# Terraform (MCP server + hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/terraform\n\n# Terraform + AWS (MCP server only)\napm install y-miyazaki/config/.apm/packages/terraform-aws\n\n# Go (hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/go\n\n# Shell Script (hook + instruction + skills)\napm install y-miyazaki/config/.apm/packages/shell-script\n```\n\n### Other targets[](https://github.com/y-miyazaki/config#other-targets)\n\n```shell\n# Claude\napm install y-miyazaki/config --target claude\n\n# Cursor\napm install y-miyazaki/config --target cursor\n\n# All targets\napm install y-miyazaki/config --target all\n```\n\n### Use in other repositories[](https://github.com/y-miyazaki/config#use-in-other-repositories)\n\nAfter adding dependencies to your project's `apm.yml`, teammates only need:\n\n```shell\napm install --frozen\n```\n\nThis resolves all dependencies from `apm.lock.yaml` and deploys skills, instructions, hooks, and MCP servers to the appropriate target directories.\n\n## GitHub Actions[](https://github.com/y-miyazaki/config#github-actions)\n\nGitHub Actions workflows are shared as reusable workflow definitions in this repository.\n\n### Reuse shared workflows[](https://github.com/y-miyazaki/config#reuse-shared-workflows)\n\nUse this repository's reusable workflows from your repository workflows:\n\n```yaml\njobs:\n  markdown:\n    uses: y-miyazaki/config/.github/workflows/ci-markdown.yaml@main\n```\n\nFor production usage, pin a commit SHA instead of a branch.\n\n## Renovate[](https://github.com/y-miyazaki/config#renovate)\n\nRenovate configuration is shared as reusable policy presets.\n\n### Reuse shared policy[](https://github.com/y-miyazaki/config#reuse-shared-policy)\n\nCreate or update your `.github/renovate.json`:\n\n```json\n{\n\t\"extends\": [\"github>y-miyazaki/config//renovate/default\"]\n}\n```\n\nThis enables the shared Renovate baseline and policy defaults maintained in this repository.\n\n## License[](https://github.com/y-miyazaki/config#license)\n\nApache-2.0\n\n## About\n\nA repository of initial settings around the editor\n\n### Topics\n\n[config](https://github.com/topics/config \"Topic: config\")\n\n### Resources\n\n[Readme](https://github.com/y-miyazaki/config#readme-ov-file)\n\n### Security policy\n\n[Security policy](https://github.com/y-miyazaki/config#security-ov-file)\n\n### Uh oh!\n\nThere was an error while loading. Please reload this page.\n\n[Activity](https://github.com/y-miyazaki/config/activity)\n\n### Stars\n\n[**1** star](https://github.com/y-miyazaki/config/stargazers)\n\n### Watchers\n\n[**1** watching](https://github.com/y-miyazaki/config/watchers)\n\n### Forks\n\n[**0** forks](https://github.com/y-miyazaki/config/forks)\n\n[Report repository](https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig&report=y-miyazaki+%28user%29)\n\n## [Releases 22](https://github.com/y-miyazaki/config/releases)[\n\nv1.1.12 Latest\n\nMay 21, 2026\n\n](https://github.com/y-miyazaki/config/releases/tag/v1.1.12)\n\n[\\+ 21 releases](https://github.com/y-miyazaki/config/releases)\n\n## [Packages 0](https://github.com/users/y-miyazaki/packages?repo_name=config)\n\n### Uh oh!\n\nThere was an error while loading. Please reload this page.\n\n## [Contributors](https://github.com/y-miyazaki/config/graphs/contributors)\n\n### Uh oh!\n\nThere was an error while loading. Please reload this page.\n\n## Languages\n\n-   [Shell 98.3%](https://github.com/y-miyazaki/config/search?l=shell)\n-   [HTML 1.4%](https://github.com/y-miyazaki/config/search?l=html)\n-   Other 0.3%\n\nYou can’t perform that action at this time.\n",
  "markdownStats": {
    "images": 0,
    "links": 37,
    "tables": 5,
    "codeBlocks": 0,
    "headings": 17
  },
  "tokens": {
    "htmlTokens": 148307,
    "markdownTokens": 2042,
    "reduction": 146265,
    "reductionPercent": 99
  },
  "score": {
    "score": 56,
    "grade": "D",
    "dimensions": {
      "semanticHtml": {
        "score": 56,
        "weight": 20,
        "grade": "D",
        "checks": {
          "uses_article_or_main": {
            "score": 100,
            "weight": 20,
            "details": "Has both <article> and <main>"
          },
          "proper_heading_hierarchy": {
            "score": 80,
            "weight": 25,
            "details": "5 <h1> elements (should be 1)"
          },
          "semantic_elements": {
            "score": 5,
            "weight": 20,
            "details": "9 semantic elements, 606 divs (ratio: 1%)"
          },
          "meaningful_alt_texts": {
            "score": 100,
            "weight": 15,
            "details": "No images found"
          },
          "low_div_nesting": {
            "score": 0,
            "weight": 20,
            "details": "Avg div depth: 17.4, max: 24"
          }
        }
      },
      "contentEfficiency": {
        "score": 48,
        "weight": 25,
        "grade": "D",
        "checks": {
          "token_reduction_ratio": {
            "score": 100,
            "weight": 40,
            "details": "99% token reduction (HTML→Markdown)"
          },
          "content_to_noise_ratio": {
            "score": 0,
            "weight": 30,
            "details": "Content ratio: 1.5% (5458 content chars / 372557 HTML bytes)"
          },
          "minimal_inline_styles": {
            "score": 0,
            "weight": 15,
            "details": "158/2531 elements with inline styles (6.2%)"
          },
          "reasonable_page_weight": {
            "score": 50,
            "weight": 15,
            "details": "HTML size: 364KB"
          }
        }
      },
      "aiDiscoverability": {
        "score": 45,
        "weight": 25,
        "grade": "D",
        "checks": {
          "has_llms_txt": {
            "score": 100,
            "weight": 20,
            "details": "llms.txt exists and is valid"
          },
          "has_robots_txt": {
            "score": 100,
            "weight": 10,
            "details": "robots.txt exists"
          },
          "robots_allows_ai_bots": {
            "score": 100,
            "weight": 15,
            "details": "All major AI bots allowed"
          },
          "has_sitemap": {
            "score": 0,
            "weight": 10,
            "details": "No sitemap found"
          },
          "supports_markdown_negotiation": {
            "score": 0,
            "weight": 25,
            "details": "No Markdown for Agents support detected"
          },
          "has_content_signals": {
            "score": 0,
            "weight": 20,
            "details": "No Content-Signal found (robots.txt or HTTP headers)"
          }
        }
      },
      "structuredData": {
        "score": 55,
        "weight": 15,
        "grade": "D",
        "checks": {
          "has_schema_org": {
            "score": 0,
            "weight": 30,
            "details": "No JSON-LD / Schema.org found"
          },
          "has_open_graph": {
            "score": 100,
            "weight": 25,
            "details": "All OG tags present"
          },
          "has_meta_description": {
            "score": 100,
            "weight": 20,
            "details": "Meta description: 70 chars"
          },
          "has_canonical_url": {
            "score": 0,
            "weight": 15,
            "details": "No canonical URL"
          },
          "has_lang_attribute": {
            "score": 100,
            "weight": 10,
            "details": "lang=\"en\""
          }
        }
      },
      "accessibility": {
        "score": 87,
        "weight": 15,
        "grade": "B",
        "checks": {
          "content_without_js": {
            "score": 100,
            "weight": 40,
            "details": "Content available without JavaScript"
          },
          "reasonable_page_size": {
            "score": 80,
            "weight": 30,
            "details": "Page size: 364KB"
          },
          "fast_content_position": {
            "score": 75,
            "weight": 30,
            "details": "Main content starts at 28% of HTML"
          }
        }
      }
    }
  },
  "recommendations": [
    {
      "id": "improve_content_ratio",
      "priority": "critical",
      "category": "contentEfficiency",
      "titleKey": "rec.improve_content_ratio.title",
      "descriptionKey": "rec.improve_content_ratio.description",
      "howToKey": "rec.improve_content_ratio.howto",
      "effort": "moderate",
      "estimatedImpact": 6,
      "checkScore": 0,
      "checkDetails": "Content ratio: 1.5% (5458 content chars / 372557 HTML bytes)"
    },
    {
      "id": "add_markdown_negotiation",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_markdown_negotiation.title",
      "descriptionKey": "rec.add_markdown_negotiation.description",
      "howToKey": "rec.add_markdown_negotiation.howto",
      "effort": "significant",
      "estimatedImpact": 6,
      "checkScore": 0,
      "checkDetails": "No Markdown for Agents support detected"
    },
    {
      "id": "add_sitemap",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_sitemap.title",
      "descriptionKey": "rec.add_sitemap.description",
      "howToKey": "rec.add_sitemap.howto",
      "effort": "quick-win",
      "estimatedImpact": 5,
      "checkScore": 0,
      "checkDetails": "No sitemap found"
    },
    {
      "id": "add_content_signals",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_content_signals.title",
      "descriptionKey": "rec.add_content_signals.description",
      "howToKey": "rec.add_content_signals.howto",
      "effort": "quick-win",
      "estimatedImpact": 5,
      "checkScore": 0,
      "checkDetails": "No Content-Signal found (robots.txt or HTTP headers)"
    },
    {
      "id": "reduce_div_nesting",
      "priority": "critical",
      "category": "semanticHtml",
      "titleKey": "rec.reduce_div_nesting.title",
      "descriptionKey": "rec.reduce_div_nesting.description",
      "howToKey": "rec.reduce_div_nesting.howto",
      "effort": "significant",
      "estimatedImpact": 4,
      "checkScore": 0,
      "checkDetails": "Avg div depth: 17.4, max: 24"
    },
    {
      "id": "remove_inline_styles",
      "priority": "critical",
      "category": "contentEfficiency",
      "titleKey": "rec.remove_inline_styles.title",
      "descriptionKey": "rec.remove_inline_styles.description",
      "howToKey": "rec.remove_inline_styles.howto",
      "effort": "moderate",
      "estimatedImpact": 3,
      "checkScore": 0,
      "checkDetails": "158/2531 elements with inline styles (6.2%)"
    },
    {
      "id": "add_schema_org",
      "priority": "high",
      "category": "structuredData",
      "titleKey": "rec.add_schema_org.title",
      "descriptionKey": "rec.add_schema_org.description",
      "howToKey": "rec.add_schema_org.howto",
      "effort": "moderate",
      "estimatedImpact": 6,
      "checkScore": 0,
      "checkDetails": "No JSON-LD / Schema.org found"
    },
    {
      "id": "add_semantic_elements",
      "priority": "high",
      "category": "semanticHtml",
      "titleKey": "rec.add_semantic_elements.title",
      "descriptionKey": "rec.add_semantic_elements.description",
      "howToKey": "rec.add_semantic_elements.howto",
      "effort": "moderate",
      "estimatedImpact": 5,
      "checkScore": 5,
      "checkDetails": "9 semantic elements, 606 divs (ratio: 1%)"
    },
    {
      "id": "add_canonical_url",
      "priority": "high",
      "category": "structuredData",
      "titleKey": "rec.add_canonical_url.title",
      "descriptionKey": "rec.add_canonical_url.description",
      "howToKey": "rec.add_canonical_url.howto",
      "effort": "quick-win",
      "estimatedImpact": 3,
      "checkScore": 0,
      "checkDetails": "No canonical URL"
    }
  ],
  "llmsTxtPreview": "# GitHub\n\n> A repository of initial settings around the editor - y-miyazaki/config\n\n## Documentation\n- [docs](https://github.com/y-miyazaki/config/tree/main/docs)\n- [AGENTS.md](https://github.com/y-miyazaki/config/blob/main/AGENTS.md)\n- [README.md](https://github.com/y-miyazaki/config/blob/main/README.md)\n- [SECURITY.md](https://github.com/y-miyazaki/config/blob/main/SECURITY.md)\n- [docs/](https://github.com/y-miyazaki/config/blob/main/docs)\n- [docs/specification.md](https://github.com/y-miyazaki/config/blob/main/docs/specification.md)\n- [docs/index.md](https://github.com/y-miyazaki/config/blob/main/docs/index.md)\n\n## Main\n- [GitHub - y-miyazaki/config: A repository of initial settings around the editor](https://github.com/y-miyazaki/config): A repository of initial settings around the editor - y-miyazaki/config\n- [GitHub CopilotWrite better code with AI](https://github.com/features/copilot)\n- [GitHub SparkBuild and deploy intelligent apps](https://github.com/features/spark)\n- [GitHub ModelsManage and compare prompts](https://github.com/features/models)\n- [ActionsAutomate any workflow](https://github.com/features/actions)\n- [CodespacesInstant dev environments](https://github.com/features/codespaces)\n- [IssuesPlan and track work](https://github.com/features/issues)\n- [Code ReviewManage code changes](https://github.com/features/code-review)\n- [View all features](https://github.com/features)\n- [Small and medium teams](https://github.com/team)\n- [Nonprofits](https://github.com/solutions/industry/nonprofits)\n- [App Modernization](https://github.com/solutions/use-case/app-modernization)\n- [DevSecOps](https://github.com/solutions/use-case/devsecops)\n- [DevOps](https://github.com/solutions/use-case/devops)\n- [CI/CD](https://github.com/solutions/use-case/ci-cd)\n- [View all use cases](https://github.com/solutions/use-case)\n- [Healthcare](https://github.com/solutions/industry/healthcare)\n- [Financial services](https://github.com/solutions/industry/financial-services)\n- [Manufacturing](https://github.com/solutions/industry/manufacturing)\n- [Government](https://github.com/solutions/industry/government)\n- [View all industries](https://github.com/solutions/industry)\n- [View all solutions](https://github.com/solutions)\n- [Business insights](https://github.com/solutions/executive-insights)\n- [Copilot for BusinessEnterprise-grade AI features](https://github.com/features/copilot/copilot-business)\n- [Pricing](https://github.com/pricing)\n- [Sign in](https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fy-miyazaki%2Fconfig)\n- [MCP RegistryNewIntegrate external tools](https://github.com/mcp)\n- [GitHub Advanced SecurityFind and fix vulnerabilities](https://github.com/security/advanced-security)\n- [Code securitySecure your code as you build](https://github.com/security/advanced-security/code-security)\n- [Secret protectionStop leaks before they start](https://github.com/security/advanced-security/secret-protection)\n- [Why GitHub](https://github.com/why-github)\n- [Marketplace](https://github.com/marketplace)\n- [Enterprises](https://github.com/enterprise)\n\n## Blog\n- [AI](https://github.com/resources/articles?topic=ai)\n- [Software Development](https://github.com/resources/articles?topic=software-development)\n- [DevOps](https://github.com/resources/articles?topic=devops)\n- [Security](https://github.com/resources/articles?topic=security)\n- [View all topics](https://github.com/resources/articles)\n\n",
  "llmsTxtExisting": "# GitHub\n\n> GitHub is a developer platform for building, shipping, and maintaining software. It provides cloud-based Git repository hosting, CI/CD via GitHub Actions, project management with Issues and Projects, code review via pull requests, AI-powered development with GitHub Copilot, and APIs (REST and GraphQL) for automation and integration.\n\n## How to use\n\nTo retrieve full article content, page lists, or search results programmatically, please use the APIs below. To find a specific article, use the **Search API** with a query. To browse all available pages, use the **Page List API** to get a list of paths, then fetch individual articles with the **Article API**. The `/api/article/body` endpoint returns markdown, ideal for LLM consumption. These APIs return structured markdown and JSON and are the preferred way for LLMs and automated tools to access GitHub documentation.\n\n* [Versions API](https://docs.github.com/api/pagelist/versions): Lists all available documentation versions.\n* [Languages API](https://docs.github.com/api/pagelist/languages): Lists all available languages.\n* [Page List API](https://docs.github.com/api/pagelist/en/free-pro-team@latest): Returns every docs page path for a given language and version.\n* [Article API](https://docs.github.com/api/article): Returns the full rendered content and context of any docs page as JSON. Example: `curl \"https://docs.github.com/api/article?pathname=/en/get-started/start-your-journey/about-github-and-git\"`\n* [Article Body API](https://docs.github.com/api/article/body): Returns the full rendered content of any docs page as markdown. Example: `curl \"https://docs.github.com/api/article/body?pathname=/en/get-started/start-your-journey/about-github-and-git\"`\n* [Search API](https://docs.github.com/api/search/v1): Search across all docs content. Example: `curl \"https://docs.github.com/api/search/v1?query=actions&language=en&version=free-pro-team@latest\"`\n* [GitHub MCP server](https://github.com/github/github-mcp-server): For agents that connect via Model Context Protocol, the GitHub MCP server provides tools for working with GitHub itself: repositories, issues, pull requests, workflows, and code. It does not currently include docs search.\n\n## Building with GitHub, for coding agents and automation\n\n* [Extend Copilot Chat with MCP](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp): Connect MCP servers to Copilot Chat to share context from other applications.\n* [Use the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/use-the-github-mcp-server): Learn how to use the GitHub Model Context Protocol (MCP) server to interact with repositories, issues, pull requests, and other GitHub features, directly from Copilot Chat in your IDE.\n* [Set up the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/set-up-the-github-mcp-server): Learn how to configure the GitHub Model Context Protocol (MCP) server.\n* [About cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent): Copilot can research a repository, create an implementation plan, and make code changes on a branch. You can review the diff, iterate, and create a pull request when you're ready.\n* [Create custom agents in your IDE](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents-in-your-ide): You can create specialized agents with tailored expertise for specific development tasks.\n* [GitHub CLI](https://docs.github.com/en/github-cli/github-cli): GitHub CLI is an open source tool for using GitHub from your computer's command line. When you're working from the command line, you can use the GitHub CLI to save time and avoid switching context.\n* [Quickstart](https://docs.github.com/en/github-cli/github-cli/quickstart): Start using GitHub CLI to work with GitHub in the command line.\n* [REST API](https://docs.github.com/en/rest): Create integrations, retrieve data, and automate your workflows with the GitHub REST API.\n* [GraphQL API](https://docs.github.com/en/graphql): To create integrations, retrieve data, and automate your workflows, use the GitHub GraphQL API. The GitHub GraphQL API offers more precise and flexible queries than the GitHub REST API.\n* [GitHub Actions](https://docs.github.com/en/actions): Automate, customize, and execute your software development workflows right in your repository with GitHub Actions. You can discover, create, and share actions to perform any job you'd like, including CI/CD, and combine actions in a completely customized workflow.\n\n## GitHub Copilot\n\n> You can use GitHub Copilot to enhance your productivity and assist as you work on code.\n\n* [GitHub Copilot](https://docs.github.com/en/copilot): You can use GitHub Copilot to enhance your productivity and assist as you work on code.\n* [Copilot requests](https://docs.github.com/en/copilot/concepts/billing/copilot-requests): Learn about requests in Copilot, including premium requests, how they work, and how to manage your usage effectively.\n* [Individual plans](https://docs.github.com/en/copilot/concepts/billing/individual-plans): GitHub offers several Copilot plans for individual developers, each with different features, model access, and usage limits to support a wide range of coding needs.\n* [Usage-based billing for individuals](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals): Your Copilot plan will include a monthly allowance of GitHub AI Credits. If you exhaust your AI credits, you can pay extra to keep working.\n* [Usage-based billing for organizations and enterprises](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises): Prepare for the transition to usage-based billing for Copilot Business and Copilot Enterprise.\n* [Usage limits](https://docs.github.com/en/copilot/concepts/usage-limits): Learn about GitHub Copilot usage limits and what to do if you hit a limit.\n* [Features](https://docs.github.com/en/copilot/get-started/features): GitHub Copilot offers a suite of features for users and administrators.\n* [Plans](https://docs.github.com/en/copilot/get-started/plans): Learn about the available plans for Copilot.\n* [Quickstart](https://docs.github.com/en/copilot/get-started/quickstart): Quickly learn how to use GitHub Copilot.\n* [What is GitHub Copilot?](https://docs.github.com/en/copilot/get-started/what-is-github-copilot): Learn what Copilot is and what you can do with it.\n* [Copilot CLI best practices](https://docs.github.com/en/copilot/how-tos/copilot-cli/cli-best-practices): Learn how to get the most out of GitHub Copilot CLI.\n* [Install Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli): Learn how to install Copilot CLI so that you can use Copilot directly from the command line.\n* [Overview](https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli/overview): Learn how to use GitHub Copilot from the command line.\n* [Add repository instructions](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions): Create repository custom instructions files that give Copilot additional context on how to understand your project and how to build, test and validate its changes.\n* [Set up for students](https://docs.github.com/en/copilot/how-tos/copilot-on-github/set-up-copilot/enable-copilot/set-up-for-students): Get free access to Copilot's premium features as a verified student.\n* [Get IDE code suggestions](https://docs.github.com/en/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions): Use GitHub Copilot to get code suggestions in your editor.\n* [Preparing for usage-based billing](https://docs.github.com/en/copilot/how-tos/manage-and-track-spending/prepare-for-your-move-to-usage-based-billing): If you're on a Copilot Pro or Copilot Pro+ plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.\n* [Troubleshoot common issues](https://docs.github.com/en/copilot/how-tos/troubleshoot-copilot/troubleshoot-common-issues): This guide describes the most common issues with GitHub Copilot and how to resolve them.\n* [Use code review](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review): Learn how to request a code review from GitHub Copilot.\n* [Supported models](https://docs.github.com/en/copilot/reference/ai-models/supported-models): Learn about the supported AI models in GitHub Copilot.\n* [Model multipliers for annual plans](https://docs.github.com/en/copilot/reference/copilot-billing/model-multipliers-for-annual-plans): After June 1, 2026, model multipliers will change for Copilot Pro and Copilot Pro+ subscribers staying on annual plans under request-based billing.\n* [Models and pricing](https://docs.github.com/en/copilot/reference/copilot-billing/models-and-pricing): See per-token pricing for the models available in GitHub Copilot and reference rates for additional usage across plans.\n* [Chat in GitHub Mobile](https://docs.github.com/en/copilot/responsible-use/chat-in-github-mobile): Learn how to use GitHub Copilot Chat responsibly by understanding its purposes, capabilities, and limitations.\n* [Copilot in GitHub Desktop](https://docs.github.com/en/copilot/responsible-use/copilot-in-github-desktop): Learn how to use Copilot in GitHub Desktop responsibly by understanding its purposes, capabilities, and limitations.\n* [GitHub Copilot Chat Cookbook](https://docs.github.com/en/copilot/tutorials/copilot-chat-cookbook): Find examples of prompts to use with GitHub Copilot Chat.\n* [Document code](https://docs.github.com/en/copilot/tutorials/copilot-chat-cookbook/document-code): Discover ways that you can use GitHub Copilot Chat to document your code.\n\n## Get started\n\n> Learn how to start building, shipping, and maintaining software with GitHub. Explore our products, sign up for an account, and connect with the world's largest development community.\n\n* [Get started](https://docs.github.com/en/get-started): Learn how to start building, shipping, and maintaining software with GitHub. Explore our products, sign up for an account, and connect with the world's largest development community.\n* [About remote repositories](https://docs.github.com/en/get-started/git-basics/about-remote-repositories): GitHub's collaborative approach to development depends on publishing commits from your local repository to GitHub for other people to view, fetch, and update.\n* [Ignoring files](https://docs.github.com/en/get-started/git-basics/ignoring-files): You can configure Git to ignore files you don't want to check in to GitHub.\n* [Manage remote repositories](https://docs.github.com/en/get-started/git-basics/managing-remote-repositories): Learn to work with your local repositories on your computer and remote repositories hosted on GitHub.\n* [Set up Git](https://docs.github.com/en/get-started/git-basics/set-up-git): At the heart of GitHub is an open-source version control system (VCS) called Git. Git is responsible for everything GitHub-related that happens locally on your computer.\n* [GitHub's plans](https://docs.github.com/en/get-started/learning-about-github/githubs-plans): An overview of GitHub's pricing plans.\n* [Types of GitHub accounts](https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts): Accounts on GitHub allow you to organize and control access to code.\n* [Start your journey](https://docs.github.com/en/get-started/start-your-journey): Brand new to GitHub? Learn the basics here.\n* [About GitHub and Git](https://docs.github.com/en/get-started/start-your-journey/about-github-and-git): You can use GitHub and Git to collaborate on work.\n* [Create an account](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github): Create a personal account to get started with GitHub.\n* [Download files](https://docs.github.com/en/get-started/start-your-journey/downloading-files-from-github): Learn how to download files from GitHub, and understand the difference between downloading, cloning, and forking.\n* [Hello World](https://docs.github.com/en/get-started/start-your-journey/hello-world): Follow this Hello World exercise to learn GitHub's pull request workflow.\n* [Connectivity problems](https://docs.github.com/en/get-started/using-github/troubleshooting-connectivity-problems): If you're having trouble connecting to GitHub, you can troubleshoot your connection, then use the GitHub Debug tool to diagnose problems.\n* [Basic formatting syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax): Create sophisticated formatting for your prose and code on GitHub with simple syntax.\n\n## Authentication\n\n> Authenticate securely to GitHub with passwords, tokens, SSH keys, and more—and keep your account protected.\n\n* [Connect with SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh): You can connect to GitHub using the Secure Shell Protocol (SSH), which provides a secure channel over an unsecured network.\n* [Add a new SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account): To configure your account on GitHub.com to use your new (or existing) SSH key, you'll also need to add the key to your account.\n* [Check for existing SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys): Before you generate an SSH key, you can check to see if you have any existing SSH keys.\n* [Generate new SSH key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent): After you've checked for existing SSH keys, you can generate a new SSH key to use for authentication, then add it to the ssh-agent.\n* [Test your SSH connection](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection): After you've set up your SSH key and added it to GitHub, you can test your connection.\n* [Authentication to GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/about-authentication-to-github): You can securely access your account's resources by authenticating to GitHub, using different credentials depending on where you authenticate.\n* [Manage personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens): You can use a personal access token in place of a password when authenticating to GitHub in the command line or with the API.\n* [Displaying verification for all commits](https://docs.github.com/en/authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits): You can enable vigilant mode for commit signature verification to mark all of your commits and tags with a signature verification status.\n* [Configure 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication): You can choose among multiple options to add a second source of authentication to your account.\n* [Configure 2FA recovery](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods): You can set up a variety of recovery methods to access your account if you lose your two-factor authentication credentials.\n* [Recover an account with 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials): If you lose access to your two-factor authentication credentials, you can use your recovery codes, or another recovery option, to regain access to your account.\n\n## Account and profile\n\n> Make GitHub work best for you by customizing your personal account settings and personalizing your profile page.\n\n* [Account and profile](https://docs.github.com/en/account-and-profile): Make GitHub work best for you by customizing your personal account settings and personalizing your profile page.\n* [Username changes](https://docs.github.com/en/account-and-profile/concepts/username-changes): You can change the username for your GitHub account.\n* [Account](https://docs.github.com/en/account-and-profile/get-started/account): Get started with your GitHub account.\n* [How-tos](https://docs.github.com/en/account-and-profile/how-tos): Learn how to accomplish specific tasks for your GitHub account and profile.\n* [Manage cookie preferences](https://docs.github.com/en/account-and-profile/how-tos/account-settings/manage-cookie-preferences): You can control how GitHub uses information from non-essential tracking cookies for enterprise marketing pages.\n* [Troubleshoot missing contributions](https://docs.github.com/en/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions): Learn common reasons that contributions may be missing from your contributions graph.\n* [Primary email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/changing-your-primary-email-address): To change your primary email address, you'll add a new email, then delete the old one.\n* [Set commit email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address): You can set the email address that is used to author commits on GitHub and on your computer.\n* [Verify your email address](https://docs.github.com/en/account-and-profile/how-tos/email-preferences/verifying-your-email-address): Verifying your primary email address ensures strengthened security, allows GitHub staff to better assist you if you forget your password, and gives you access to more features on GitHub.\n* [Personalize your profile](https://docs.github.com/en/account-and-profile/tutorials/personalize-your-profile): You can share information about yourself with other users by setting a profile picture and adding a bio to your profile.\n\n## GitHub Pages\n\n> GitHub Pages turns any GitHub repository into a live website—no separate hosting required.\n\n* [GitHub Pages](https://docs.github.com/en/pages): GitHub Pages turns any GitHub repository into a live website—no separate hosting required.\n* [Configure a custom domain](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site): You can customize the domain name of your GitHub Pages site.\n* [Custom domains in GitHub Pages](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages): GitHub Pages supports using custom domains, or changing the root of your site's URL from the default, like octocat.github.io, to any domain you own.\n* [Manage a custom domain](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site): You can set up or update certain DNS records and your repository settings to point the default domain for your GitHub Pages site to a custom domain.\n* [Configure publishing source](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site): You can configure your GitHub Pages site to publish when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.\n* [Create a GitHub Pages site](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site): You can create a GitHub Pages site in a new or existing repository.\n* [What is GitHub Pages?](https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages): You can use GitHub Pages to host a website about yourself, your organization, or your project directly from a repository on GitHub.\n* [Quickstart](https://docs.github.com/en/pages/quickstart): You can use GitHub Pages to showcase some open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.\n* [Add theme to Pages site](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll): You can personalize your Jekyll site by adding and customizing a theme.\n\n## Repositories\n\n> Learn to use and manage the repositories that allow you to store and collaborate on your project's code.\n\n* [About rulesets](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets): Rulesets help you to control how people can interact with branches and tags in a repository.\n* [Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository): When you create a repository on GitHub, it exists as a remote repository. You can clone your repository to create a local copy on your computer and sync between the two locations.\n* [Quickstart for repositories](https://docs.github.com/en/repositories/creating-and-managing-repositories/quickstart-for-repositories): Learn how to create a new repository and commit your first change in 5 minutes.\n* [About READMEs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes): You can add a README file to your repository to tell other people why your project is useful, what they can do with your project, and how they can use it.\n* [Licensing a repository](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository): Public repositories on GitHub are often used to share open source software. For your repository to truly be open source, you'll need to license it so that others are free to use, change, and distribute the software.\n* [About releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases): You can create a release to package software, along with release notes and links to binary files, for other people to use.\n\n## GitHub Actions\n\n> Automate, customize, and execute your software development workflows right in your repository with GitHub Actions. You can discover, create, and share actions to perform any job you'd like, including CI/CD, and combine actions in a completely customized workflow.\n\n* [Quickstart](https://docs.github.com/en/actions/get-started/quickstart): Try out the core features of GitHub Actions in minutes.\n* [Understand GitHub Actions](https://docs.github.com/en/actions/get-started/understand-github-actions): Learn the basics of core concepts and essential terminology in GitHub Actions.\n* [Workflow syntax](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax): A workflow is a configurable automated process made up of one or more jobs. You must create a YAML file to define your workflow configuration.\n\n## Apps\n\n> Go deeper with GitHub by integrating with our APIs and webhooks, customizing your GitHub workflow, and building and sharing apps with the community.\n\n* [About creating apps](https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps): GitHub Apps let you build integrations to automate processes and extend GitHub's functionality.\n* [Authorizing OAuth apps](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps): You can connect your GitHub identity to third-party applications using OAuth. When authorizing an OAuth app, you should ensure you trust the application, review who it's developed by, and review the kinds of information the application wants to access.\n* [Authorize](https://docs.github.com/en/apps/using-github-apps/authorizing-github-apps): You can authorize a GitHub App to retrieve information about your GitHub account and to make changes on your behalf.\n\n## Pull requests\n\n> Learn how to use pull requests to suggest changes to a project, receive suggested changes to your own projects, and address issues in pull requests, such as merge conflicts.\n\n* [Compare branches](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests): Pull requests display diffs to compare the changes you made in your topic branch against the base branch that you want to merge your changes into.\n* [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests): Pull requests let you propose, review, and merge code changes.\n* [Fork a repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo): A fork is a new repository that shares code and visibility settings with the original upstream repository.\n\n## More pages\n\n* [GitHub Actions](https://docs.github.com/en/billing/concepts/product-billing/github-actions): Learn how usage of GitHub Actions is measured against your free allowance and how to pay for additional use.\n* [GitHub Models](https://docs.github.com/en/billing/concepts/product-billing/github-models): If you want to use GitHub Models beyond the free usage included in your account, you can choose to opt in to paid usage.\n* [Configure security updates](https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/secure-your-dependencies/configuring-dependabot-security-updates): You can use Dependabot security updates or manual pull requests to easily update vulnerable dependencies.\n* [Codespaces](https://docs.github.com/en/codespaces): Create a codespace to start developing in a secure, configurable, and dedicated development environment that works how and where you want it to.\n* [Installation](https://docs.github.com/en/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop): You can install GitHub Desktop on supported Windows or macOS operating systems.\n* [Participate in discussion](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion): You can converse with the community and maintainers in a forum within the repository for a project on GitHub.\n* [Prototype with AI models](https://docs.github.com/en/github-models/use-github-models/prototyping-with-ai-models): Find and experiment with AI models for free.\n* [About Projects](https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects): Projects is an adaptable, flexible tool for planning and tracking work on GitHub.\n* [About GitHub Importer](https://docs.github.com/en/migrations/importing-source-code/using-github-importer/about-github-importer): If your source code is stored on another Git-based hosting service, you can move the code to GitHub.com using GitHub Importer.\n* [OAuth app restrictions](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/about-oauth-app-access-restrictions): Organizations can choose which OAuth apps have access to their repositories and other resources by enabling OAuth app access restrictions.\n* [Container registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry): You can store and manage Docker and OCI images in the Container registry.\n* [Authenticating](https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api): You can authenticate to the REST API to access more endpoints and have a higher rate limit.\n* [Permissions for fine-grained PATs](https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens): For each permission granted to a fine-grained personal access token, these are the REST API endpoints that the app can use.\n* [Code search syntax](https://docs.github.com/en/search-github/github-code-search/understanding-github-code-search-syntax): You can build search queries for the results you want with specialized code qualifiers, regular expressions, and boolean operations.\n* [Disable webhooks](https://docs.github.com/en/webhooks/using-webhooks/disabling-webhooks): You can disable a webhook to unsubscribe from events that occur on GitHub.\n\n<!-- This file is automatically generated. Do not edit manually. -->",
  "emergingProtocols": {
    "oauthDiscovery": {
      "exists": false,
      "url": "https://github.com/.well-known/oauth-authorization-server"
    },
    "mcpServerCard": {
      "exists": false,
      "url": "https://github.com/.well-known/mcp.json"
    },
    "a2aAgentCard": {
      "exists": false,
      "url": "https://github.com/.well-known/agent.json"
    },
    "count": 0
  },
  "snippets": [
    {
      "id": "add_canonical_url",
      "title": "Add canonical URL",
      "description": "The canonical URL tells AI agents which version of the page is the \"official\" one, avoiding duplicate content issues.",
      "language": "html",
      "code": "<link rel=\"canonical\" href=\"https://github.com/y-miyazaki/config\">",
      "filename": "<head>"
    },
    {
      "id": "add_schema_org",
      "title": "Add Schema.org JSON-LD",
      "description": "Structured data helps AI agents understand the type, author, and purpose of your content.",
      "language": "html",
      "code": "<script type=\"application/ld+json\">\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"WebPage\",\n  \"name\": \"GitHub - y-miyazaki/config: A repository of initial settings around the editor\",\n  \"description\": \"A repository of initial settings around the editor - y-miyazaki/config\",\n  \"url\": \"https://github.com/y-miyazaki/config\",\n  \"inLanguage\": \"en\",\n  \"isPartOf\": {\n    \"@type\": \"WebSite\",\n    \"name\": \"GitHub\"\n  }\n}\n</script>",
      "filename": "<head>"
    },
    {
      "id": "add_sitemap",
      "title": "Create /sitemap.xml",
      "description": "A sitemap helps AI agents discover all your pages. Most CMS platforms generate one automatically.",
      "language": "xml",
      "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <url>\n    <loc>https://github.com/y-miyazaki/config</loc>\n    <lastmod>2026-05-21</lastmod>\n  </url>\n</urlset>",
      "filename": "/sitemap.xml"
    },
    {
      "id": "add_content_signals",
      "title": "Add Content-Signal directives",
      "description": "Content-Signal tells AI agents how they may use your content. The canonical location is robots.txt, but you can also expose it as an HTTP header from any stack.",
      "language": "txt",
      "code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no",
      "filename": "/robots.txt",
      "stacks": [
        {
          "id": "robots",
          "label": "robots.txt",
          "language": "txt",
          "filename": "/robots.txt",
          "code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no"
        },
        {
          "id": "nginx",
          "label": "Nginx",
          "language": "nginx",
          "filename": "server block",
          "code": "# Inside your server { } block:\nadd_header Content-Signal \"search=yes, ai-input=yes, ai-train=no\" always;"
        },
        {
          "id": "apache",
          "label": "Apache",
          "language": "apache",
          "filename": ".htaccess",
          "code": "# In .htaccess (or VirtualHost):\nHeader set Content-Signal \"search=yes, ai-input=yes, ai-train=no\""
        },
        {
          "id": "wordpress",
          "label": "WordPress",
          "language": "php",
          "filename": "functions.php",
          "code": "<?php\n// In your theme's functions.php or a small mu-plugin\nadd_action('send_headers', function () {\n    header('Content-Signal: search=yes, ai-input=yes, ai-train=no');\n});\n\n// Optional: also append the directive to the dynamic robots.txt\nadd_filter('robots_txt', function ($output) {\n    return $output . \"\\nContent-Signal: search=yes, ai-input=yes, ai-train=no\\n\";\n}, 10, 1);"
        },
        {
          "id": "nextjs",
          "label": "Next.js",
          "language": "typescript",
          "filename": "middleware.ts",
          "code": "// middleware.ts (Next.js 13+ App Router or Pages Router)\nimport { NextResponse } from 'next/server';\nexport function middleware() {\n  const res = NextResponse.next();\n  res.headers.set(\n    'Content-Signal',\n    'search=yes, ai-input=yes, ai-train=no'\n  );\n  return res;\n}\nexport const config = { matcher: '/:path*' };"
        },
        {
          "id": "cloudflare",
          "label": "Cloudflare Workers",
          "language": "javascript",
          "filename": "worker.js",
          "code": "// Cloudflare Worker that proxies your origin and adds the header\nexport default {\n  async fetch(request, env, ctx) {\n    const res = await fetch(request);\n    const newRes = new Response(res.body, res);\n    newRes.headers.set(\n      'Content-Signal',\n      'search=yes, ai-input=yes, ai-train=no'\n    );\n    return newRes;\n  },\n};"
        },
        {
          "id": "express",
          "label": "Express / Fastify",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Express\napp.use((req, res, next) => {\n  res.setHeader('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n  next();\n});\n\n// Fastify\nfastify.addHook('onSend', (request, reply, payload, done) => {\n  reply.header('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n  done();\n});"
        }
      ]
    },
    {
      "id": "add_markdown_negotiation",
      "title": "Support Markdown for Agents",
      "description": "Let AI agents request a clean Markdown version of any page via content negotiation, .md alternate URLs, link tags or Link headers.",
      "language": "html",
      "code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">",
      "filename": "<head>",
      "stacks": [
        {
          "id": "html",
          "label": "HTML <head>",
          "language": "html",
          "filename": "<head>",
          "code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
        },
        {
          "id": "express",
          "label": "Express",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Mechanisms 1 + 4: content negotiation + Link header\napp.get('/page', (req, res) => {\n  res.setHeader('Vary', 'Accept');\n  res.setHeader('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n  if ((req.headers.accept || '').includes('text/markdown')) {\n    res.type('text/markdown; charset=utf-8');\n    return res.send(renderMarkdown('page'));\n  }\n  res.render('page');\n});"
        },
        {
          "id": "fastify",
          "label": "Fastify",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Mechanisms 1 + 4: content negotiation + Link header\nfastify.get('/page', async (req, reply) => {\n  reply.header('Vary', 'Accept');\n  reply.header('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n  if ((req.headers.accept || '').includes('text/markdown')) {\n    return reply.type('text/markdown; charset=utf-8').send(renderMarkdown('page'));\n  }\n  return reply.view('/page.ejs');\n});"
        },
        {
          "id": "nextjs",
          "label": "Next.js",
          "language": "typescript",
          "filename": "app/page/route.ts",
          "code": "// Next.js App Router — Route Handler returning Markdown\nimport { NextRequest } from 'next/server';\nimport { renderMarkdown } from '@/lib/md';\nexport async function GET(req: NextRequest) {\n  const accept = req.headers.get('accept') || '';\n  if (accept.includes('text/markdown')) {\n    return new Response(await renderMarkdown('page'), {\n      headers: {\n        'Content-Type': 'text/markdown; charset=utf-8',\n        'Vary': 'Accept',\n      },\n    });\n  }\n  // Fall through to the page component\n  return new Response(null, { status: 404 });\n}"
        },
        {
          "id": "wordpress",
          "label": "WordPress",
          "language": "php",
          "filename": "functions.php",
          "code": "<?php\n// Mechanism 1: respond to Accept: text/markdown on the same URL\nadd_action('template_redirect', function () {\n    if (!is_singular()) return;\n    $accept = $_SERVER['HTTP_ACCEPT'] ?? '';\n    if (strpos($accept, 'text/markdown') === false) return;\n    header('Content-Type: text/markdown; charset=utf-8');\n    header('Vary: Accept');\n    $post = get_queried_object();\n    echo \"# \" . get_the_title($post) . \"\\n\\n\";\n    echo wp_strip_all_tags(apply_filters('the_content', $post->post_content));\n    exit;\n});"
        },
        {
          "id": "static",
          "label": "Hugo / Jekyll / Astro",
          "language": "txt",
          "filename": "static/page.md",
          "code": "# Mechanism 2: serve .md alongside .html\n# Hugo: place page.md in /static/ — built unchanged\n# Jekyll: drop page.md in /assets/ — copied as-is\n# Astro: src/pages/page.md.ts that exports a GET returning markdown\n\n# Then advertise with mechanism 3 in <head>:\n#   <link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
        }
      ]
    }
  ]
}

API를 사용하여 프로그래밍 방식으로 가져올 수 있습니다 (곧 출시)

이 JSON은 내부용입니다 — Markdown 및 llms.txt 파일과 달리 사이트에 업로드하기 위한 것이 아닙니다. 시간에 따른 점수 추적을 위한 기준값으로 저장하거나, 개발팀과 공유하거나, CI/CD 파이프라인에 통합하세요.

결과 공유

또는 AI에게 개선 방법을 물어보세요

다른 의견도 들어보시겠어요?

Cloudflare에도 무료 스캐너가 있는데, 던지는 질문이 다릅니다. 그쪽은 에이전트가 호출할 수 있도록 사이트가 게시한 것(MCP 서버 카드, Agent Skills, API 카탈로그, DNS 레코드)을 채점합니다. 저희는 에이전트가 콘텐츠에 도달해 읽고 이해할 수 있는지를 채점합니다. 한쪽은 좋고 다른 쪽은 나쁠 수 있으니 두 점수가 다른 것은 당연합니다. 서로 다른 질문에 대한 답이고, 둘 다 알아둘 가치가 있습니다.

Cloudflare로 github.com 검사하기

배지 삽입

이 배지를 사이트에 추가하세요. AI 준비도 점수가 변경되면 자동으로 업데이트됩니다.

AgentReady.md score for github.com
Script 권장
<script src="https://agentready.md/badge.js" data-id="9ee93ab6-4046-49c1-8a45-dec4ff03567c" data-domain="github.com"></script>
Markdown
[![AgentReady.md score for github.com](https://agentready.md/badge/github.com.svg)](https://agentready.md/ko/r/9ee93ab6-4046-49c1-8a45-dec4ff03567c)

곧 출시: 전체 도메인 분석

전체 도메인을 크롤링하고, llms.txt를 생성하고, AI 준비도 점수를 시간에 따라 모니터링하세요. 대기자 명단에 등록하여 알림을 받으세요.

명단에 등록되었습니다! 서비스 출시 시 알려드리겠습니다.