# Contributing to Structural Cognition Seed

**结构认知种子仓库 · 贡献指南**

---

> *"互指无界" — 多结构互看，各自照亮对方盲区。*
> *"Mutual reference is unbounded" — multiple structures viewing each other illuminate each other's blind spots.*

---

Thank you for your interest in contributing to the Structural Cognition framework. This repository is the seed — the canonical collection of papers establishing the four-axiom structural cognition system (四公理体系), authored by **林小黑 (Lin Xiaohei)**.

## Scope

This repository is **not** a general-purpose research collaboration space. It is the curated seed repository for the Structural Cognition framework. Contributions are welcome in the following areas:

### What We Welcome

1. **Translations** — Translating existing papers into new languages while preserving the original meaning and attribution
2. **Formatting & Accessibility** — Converting papers between formats (Markdown, LaTeX, PDF), improving typography, adding TOC
3. **Corrections** — Fixing typos, formatting errors, broken links
4. **Supplementary Materials** — Adding diagrams, visualizations, explanatory notes (must not alter the core arguments)
5. **Cross-References** — Adding links between related papers, building citation graphs
6. **Applications** — Demonstrating applications of structural cognition in new domains with rigorous methodology
7. **Peer Review** — Constructive critique, identification of logical gaps, suggested improvements

### What We Do Not Accept

- **Changes to core axioms or theorems** — The four axioms and meta-theorem are the foundation; they may not be modified by contributors
- **Unauthorized additions** — Do not add papers not written or authorized by 林小黑 without explicit permission
- **Attribution changes** — All papers must retain the original author attribution (林小黑, 2026年6月)

## How to Contribute

### 1. Fork and Clone

```bash
git clone https://github.com/nousresearch/structural-cognition-seed.git
cd structural-cognition-seed
```

### 2. Create a Branch

```bash
git checkout -b your-feature-name
```

### 3. Make Changes

Follow these guidelines:
- Use clear commit messages
- Keep changes focused — one type of change per pull request
- For translations: maintain the original paper's structure and exact meaning
- For formatting: ensure no content is lost or altered

### 4. Submit a Pull Request

Include in your PR description:
- What you changed and why
- Which papers or files are affected
- Any relevant context or discussion

## Contribution Types in Detail

### Translations

When translating papers:
1. Preserve the original filename pattern: `{title}-{language}.md`
2. Include the original abstract in the target language header
3. Preserve all copyright notices and author attribution
4. Maintain the original section structure
5. Add a translator credit line at the bottom: `> Translated by [Your Name], [Year]`

### Formatting

When improving formatting:
1. Do not rephrase or reinterpret the content
2. Markdown files should use standard GitHub-flavored Markdown
3. For LaTeX conversions, test compilation before submitting
4. Tables, equations, and mathematical notation must be preserved exactly

### Applications

When demonstrating structural cognition in a new domain:
1. Clearly reference which axioms/theorems you are applying
2. Provide rigorous methodology
3. Include reproducible experiments where possible
4. Discuss limitations honestly
5. Use the established naming conventions (嵌套率, 对极耦合, etc.)

## Code of Conduct

This is a scholarly repository. All interactions should be:
- **Respectful** — Engage with ideas, not personalities
- **Constructive** — Critique should aim to improve, not to tear down
- **Honest** — Acknowledge the boundaries of your own understanding
- **Attributed** — Give credit where credit is due

As the framework itself teaches: *self-reference is bounded, mutual reference is unbounded.* Let us illuminate each other's blind spots.

## Licensing

All original papers in this repository are the intellectual property of **林小黑 (Lin Xiaohei)**. Any derivative works (translations, formats, supplementary materials) must retain original attribution. See individual papers for specific copyright notices.

By contributing, you agree that your contributions (translations, formatting improvements, etc.) will be distributed under the same attribution requirements as the original papers.

## Contact

For questions about the framework, permissions, or contribution inquiries, contact the repository maintainers through GitHub issues.

---

> *"结构公理体系不寻找最小粒子。它提炼所有存在共通的演化规则。"*
> *"The structural axiom system does not search for the smallest particle. It extracts the evolution rules common to all existence."*
>
> — 林小黑, 2026