{"id":30889011,"url":"https://github.com/thinknimble/tn-research","last_synced_at":"2026-02-17T22:31:47.465Z","repository":{"id":312344093,"uuid":"1047195453","full_name":"thinknimble/tn-research","owner":"thinknimble","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-29T20:10:34.000Z","size":2014,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-30T07:57:25.663Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thinknimble.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-29T22:49:46.000Z","updated_at":"2026-01-29T20:10:37.000Z","dependencies_parsed_at":"2025-10-02T12:33:16.312Z","dependency_job_id":null,"html_url":"https://github.com/thinknimble/tn-research","commit_stats":null,"previous_names":["thinknimble/tn-research"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thinknimble/tn-research","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinknimble%2Ftn-research","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinknimble%2Ftn-research/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinknimble%2Ftn-research/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinknimble%2Ftn-research/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thinknimble","download_url":"https://codeload.github.com/thinknimble/tn-research/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinknimble%2Ftn-research/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29560763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T21:50:49.831Z","status":"ssl_error","status_checked_at":"2026-02-17T21:46:15.313Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-08T15:51:50.458Z","updated_at":"2026-02-17T22:31:47.458Z","avatar_url":"https://github.com/thinknimble.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://thinknimble.com\"\u003e\n    \u003cimg src=\"assets/thinknimble-logo.png\" alt=\"ThinkNimble Logo\" width=\"300\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eThinkNimble Research Institute\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://research.thinknimble.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Website-research.thinknimble.com-blue\" alt=\"Website\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/thinknimble/tn-research/actions\"\u003e\u003cimg src=\"https://github.com/thinknimble/tn-research/actions/workflows/jekyll.yml/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://jekyllrb.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Jekyll-4.0-CC0000\" alt=\"Jekyll\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-green\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eWe don't know what \"it\" is, but we've been doing it for a long time.\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  The world is like that. We are a group of builders, entrepreneurs, and downright\u003cbr\u003e\n  curious people trying to figure things out — just like you are, we expect.\u003cbr\u003e\n  \u003cbr\u003e\n  The mission of our so-called \"Research Institute\" is to share what we've learned\u003cbr\u003e\n  in order to help others navigate the world.\n\u003c/p\u003e\n\n---\n\n## What We Share\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\" valign=\"top\"\u003e\n\n### Essays\n**Deep explorations**\n\nLong-form pieces that synthesize research, explore complex topics, and present original thinking on technology and its implications.\n\n\u003c/td\u003e\n\u003ctd width=\"33%\" valign=\"top\"\u003e\n\n### Digital Garden\n**Knowledge building blocks**\n\nOur collection of interconnected notes — short-form insights and observations that serve as atomic units of thought, linked wiki-style to form a knowledge graph.\n\n\u003c/td\u003e\n\u003ctd width=\"33%\" valign=\"top\"\u003e\n\n### Projects\n**Things we've built**\n\nShowcases of our work in software engineering, AI systems, and human-computer interaction — tools, experiments, and solutions we've created along the way.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## Key Features\n\n### Content Organization\n- **Wiki-style linking** - Interconnected notes that build a knowledge graph\n- **AI attribution system** - Transparent labeling of human-written, AI-supported, and AI-generated content\n- **Status indicators** - Track content maturity from seed ideas to evergreen pieces\n- **Author profiles** - Learn about our contributors and their areas of expertise\n\n### Technical Excellence\n- **Lightning-fast static site** - Built with Jekyll for optimal performance\n- **Privacy-focused analytics** - Using Fathom instead of invasive tracking\n- **Dark/light themes** - Automatic theme switching based on system preferences\n- **Mobile-responsive** - Optimal reading experience on any device\n- **Syntax highlighting** - Beautiful code examples with language-specific highlighting\n\n## Local Development\n\n### Prerequisites\n\n- [Docker](https://www.docker.com/get-started) and Docker Compose\n- [Just](https://github.com/casey/just) command runner (`brew install just`)\n- Git\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/thinknimble/tn-research.git\ncd tn-research\n\n# Start the development server (with live reload)\njust up\n\n# Visit http://localhost:4001\n```\n\nThe Docker setup automatically installs all dependencies and starts Jekyll with live reload enabled.\n\n### Development Commands\n\n```bash\n# Start development server\njust up\n\n# Stop Docker containers\njust down\n\n# Rebuild Docker image\njust build\n\n# Clean all artifacts and Docker resources\njust reset\n\n# Run with drafts enabled\nJEKYLL_DRAFTS=true just up\n\n# Check for broken internal links\njust check-links\n```\n\n### Creating Content\n\n```bash\n# Create a new note\njust new-note \"Your Note Title\"\n\n# Create a new essay\njust new-essay \"Your Essay Title\"\n\n# Create a new project\njust new-project \"Your Project Title\"\n```\n\nThese commands create properly formatted markdown files with all required frontmatter fields in the appropriate directories.\n\n## Content Structure\n\n### Collections\n\nThe site uses Jekyll collections to organize different content types:\n\n```\n_essays/          # Long-form essays and analysis\n_notes/           # Atomic notes and knowledge fragments  \n_posts/           # Blog posts (YYYY-MM-DD-title.md format)\n_publications/    # Formal research publications\n_projects/        # Project showcases and case studies\n_authors/         # Author profiles and bios\n```\n\n### Front Matter Templates\n\n\u003e **Note**: Use `just new-note`, `just new-essay`, or `just new-project` to automatically create files with proper frontmatter.\n\n\u003cdetails\u003e\n\u003csummary\u003eNote Template\u003c/summary\u003e\n\n```yaml\n---\nlayout: note\ntitle: \"Note Title\"\ndate: YYYY-MM-DD\nupdated: YYYY-MM-DD\ntags: [tag1, tag2]\nattribution: human-written  # or ai-supported, ai-generated\nauthors: [\"Author Name\"]\nstatus: budding  # or seed, evergreen\nsummary: \"Brief description\"\n---\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eEssay Template\u003c/summary\u003e\n\n```yaml\n---\nlayout: essay\ntitle: \"Your Essay Title\"\nsubtitle: \"Optional subtitle\"\ndate: YYYY-MM-DD\nauthors: [\"Author Name\"]\nattribution: human-written  # or ai-supported, ai-generated\nabstract: \"Brief summary\"\nreadtime: \"15 min read\"\nstatus: draft  # or seed, published\npublished: false  # or true\nrelated_notes: [note-slug-1, note-slug-2]\n---\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eProject Template\u003c/summary\u003e\n\n```yaml\n---\nlayout: project\ntitle: \"Project Title\"\nsubtitle: \"Brief tagline\"\ndate: YYYY-MM-DD\nend_date: present  # or YYYY-MM-DD\nstatus: active  # or completed, archived\nbanner_image: \"https://...\"\ndescription: \"Detailed description\"\ntechnologies:\n  - Technology One\n  - Technology Two\ngithub_url: \"https://github.com/...\"\ntags: [tag1, tag2]\n---\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003ePublication Template\u003c/summary\u003e\n\n```yaml\n---\nlayout: publication\ntitle: \"Publication Title\"\ndate: YYYY-MM-DD\nauthors:\n  - Author One\n  - Author Two\nabstract: \"Brief description\"\nattribution: human-written\npdf_url: \"/path/to/pdf\"  # optional\narxiv_url: \"https://arxiv.org/...\"  # optional\ndoi: \"10.xxxx/xxxxx\"  # optional\n---\n```\n\u003c/details\u003e\n\n## AI Attribution Policy\n\nWe believe in transparency about AI use in content creation. All content includes an attribution field:\n\n- **Human Written** - Created entirely by human effort\n- **AI Supported** - Human-AI collaboration\n- **AI Generated** - Primarily AI-created with human oversight\n\nLearn more in our [AI Attribution Policy](https://research.thinknimble.com/notes/ai-attribution-policy).\n\n## Deployment\n\nThe site automatically deploys to GitHub Pages when changes are pushed to the `main` branch. CloudFlare handles DNS and CDN services.\n\n### Deployment Pipeline\n\n1. Push to `main` triggers GitHub Actions\n2. Jekyll builds the static site\n3. Deploys to GitHub Pages\n4. CloudFlare serves from research.thinknimble.com\n\n## Project Structure\n\n```\ntn-research/\n├── _includes/        # Reusable components\n├── _layouts/         # Page templates\n├── _essays/          # Essay content\n├── _notes/           # Note content\n├── _posts/           # Blog posts\n├── _publications/    # Research publications\n├── _projects/        # Project showcases\n├── _authors/         # Author profiles\n├── assets/           # Images and media\n├── static/           \n│   ├── css/         # Stylesheets\n│   └── images/      # Site images\n├── scripts/         # Utility scripts\n├── _config.yml      # Jekyll configuration\n└── index.html       # Homepage\n```\n\n## Tools \u0026 Utilities\n\n### Link Checker\nCheck for broken internal links:\n\n```bash\npython3 scripts/check_internal_links.py\n```\n\nThis tool:\n- Scans all content for internal links\n- Warns about missing wiki-style links (expected for planned content)\n- Identifies actual broken links\n- Ignores template variables and documentation files\n\n## Contributing\n\nWe welcome contributions from the ThinkNimble team and the broader community.\n\n### For ThinkNimble Team\n\n1. Create a feature branch: `git checkout -b feature-name`\n2. Make your changes\n3. Test locally: `bundle exec jekyll serve`\n4. Check links: `python3 scripts/check_internal_links.py`\n5. Submit a pull request\n\n### For External Contributors\n\n1. Fork the repository\n2. Create your feature branch\n3. Make your changes\n4. Submit a pull request with a clear description\n\n### Content Guidelines\n\n- Follow existing formatting and style conventions\n- Include appropriate front matter\n- Add AI attribution when applicable\n- Use wiki-style links `[[Note Title]]` to connect ideas\n- Test your changes locally before submitting\n\n## License\n\n- **Code**: Apache License 2.0\n- **Content**: Creative Commons Attribution 4.0 International (CC BY 4.0)\n\nSee [LICENSE](LICENSE) for details.\n\n## Support \u0026 Contact\n\n- **Website**: [thinknimble.com](https://thinknimble.com)\n- **Email**: hello@thinknimble.com\n- **GitHub**: [@thinknimble](https://github.com/thinknimble)\n- **Research Site**: [research.thinknimble.com](https://research.thinknimble.com)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Built with Jekyll • Hosted on GitHub Pages • Powered by curiosity\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinknimble%2Ftn-research","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthinknimble%2Ftn-research","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinknimble%2Ftn-research/lists"}