# Indexing Awareness

> プロジェクトの構造インデックスと依存関係トレースにより、RAG的なコンテキスト取得を実現するスキル

- **Type:** Skill
- **Install:** `agentstack add skill-imkohenauser-antigravity-starter-ja-indexing-awareness`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [imkohenauser](https://agentstack.voostack.com/s/imkohenauser)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** ISC
- **Upstream author:** [imkohenauser](https://github.com/imkohenauser)
- **Source:** https://github.com/imkohenauser/antigravity-starter-ja/tree/main/.agent/skills/indexing-awareness

## Install

```sh
agentstack add skill-imkohenauser-antigravity-starter-ja-indexing-awareness
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Indexing Awareness Skill

Antigravity はリポジトリの事前インデックス化を行わないため、エージェントが **自律的に** プロジェクト構造を把握し、依存関係を検索する必要があります。
このスキルは、Cursor の RAG（事前インデックス + 関連コンテキスト検索）を擬似的に再現するスクリプト群を提供します。

## Triggers (自動実行のタイミング)

エージェントは以下の状況で、対応するスクリプトを **自発的に** 実行すること。
人間からの指示を待たず、ルール `indexing-codebase.md` に従って自律判断する。

| 状況 | 実行するスクリプト |
|---|---|
| 初見のプロジェクト・新しいタスク開始時 | `index-structure.sh` |
| ファイルの変更・追加・削除を行う前 | `trace-dependencies.sh ` |
| 未知の関数・クラス・シンボルを参照する前 | `trace-dependencies.sh ` |
| ルール・ワークフロー・スキルの構成を変更した後 | `verify-structure.sh` |

## Scripts

### 1. index-structure.sh (構造インデックス)

プロジェクトのディレクトリ構造、ファイル種別、サイズをインデックス化します。

```bash
# 実行権限の付与（初回のみ）
chmod +x .agent/skills/indexing-awareness/scripts/index-structure.sh

# プロジェクト全体のインデックス
./.agent/skills/indexing-awareness/scripts/index-structure.sh

# 探索深度を指定（デフォルト: 4）
./.agent/skills/indexing-awareness/scripts/index-structure.sh --depth 6

# 特定ディレクトリのみ
./.agent/skills/indexing-awareness/scripts/index-structure.sh --dir src/
```

### 2. trace-dependencies.sh (依存関係トレース)

ファイルまたはシンボルの依存関係を **双方向** に検索します。

```bash
chmod +x .agent/skills/indexing-awareness/scripts/trace-dependencies.sh

# ファイルモード: 依存関係の双方向トレース
./.agent/skills/indexing-awareness/scripts/trace-dependencies.sh src/utils/auth.ts

# シンボルモード: 定義元と使用箇所の検索
./.agent/skills/indexing-awareness/scripts/trace-dependencies.sh handleLogin

# 検索範囲を限定
./.agent/skills/indexing-awareness/scripts/trace-dependencies.sh UserService src/
```

**ファイルモード出力:**
- 📥 Forward Dependencies — そのファイルが何を import/require しているか
- 📤 Reverse Dependencies — そのファイルを誰が import/require しているか
- 🔍 Config/Doc References — 設定ファイルやドキュメントからの参照

**シンボルモード出力:**
- 📌 Definitions — 定義元（function, class, const, def, fn 等）
- 📎 Usages — 使用箇所（word boundary マッチ）
- 📦 Import References — import/require/from 文での参照

### 3. verify-structure.sh (ドキュメント整合性チェック)

`.agent/` 内のルール・ワークフロー・スキルと `README.md` の記載整合性を検証します。

```bash
chmod +x .agent/skills/indexing-awareness/scripts/verify-structure.sh
./.agent/skills/indexing-awareness/scripts/verify-structure.sh
```

## Troubleshooting

- **`trace-dependencies.sh` の結果がノイジー**: 第2引数で検索範囲を限定してください。
- **`index-structure.sh` の出力が長すぎる**: `--depth 2` でツリーの深さを制限してください。
- **`verify-structure.sh` で "Missing in README" エラー**: `README.md` に適切な記述を追加してください。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [imkohenauser](https://github.com/imkohenauser)
- **Source:** [imkohenauser/antigravity-starter-ja](https://github.com/imkohenauser/antigravity-starter-ja)
- **License:** ISC

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-imkohenauser-antigravity-starter-ja-indexing-awareness
- Seller: https://agentstack.voostack.com/s/imkohenauser
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.