The Adaptive Filesystem | (Holloway) Chew, Kean Ho's Knowledge Research

Having trouble packaging or working with various filesystem hierarchy layouts simultaneously, especially when dealing with BSD, Linux, Windows, and MacOS? Are you looking for an adaptive filesystem that fits into all of them, simplifying your software product with a single layout? This is the right research repository.

At (Holloway) Chew, Kean Ho's The Adaptive Filesystem Research Project, tech volunteers are continuously updating the repository's datasets and abstracting the three vital layouts:

• Common - the common structure used everywhere, including operating systems, project repositories, and package designs.
• Root - the operating system filesystem hierarchy.
• User - the user directory layout.

The research goals are simple:

1. Maximizing Compatibilities, Minimizing Conflicts - analyzes and abstracts various standards for common patterns. Through these patterns, a new layout is defined, maximizing inter-compatibilities and minimizing conflicts across multiple operating systems; AND
2. Unifying Filesystems - with a single adaptive filesystem, packaging software and distributing it to end-users is simplified and unified, making maintenance, automation, documentation, and communications seamless; AND
3. Solid and Hygienic Design References - with an adaptive filesystem, this repository becomes a lighthouse for designing any project layout structures, architecting operating system directory layouts, and defining a simplified and secure packaging system.

This repository is 100% deterministic with futuristic directive consequences. It is 100% human-made, and generative artificial intelligence (AI) contributions (e.g., vibe coding) ARE STRICTLY PROHIBITED. AI is ONLY USED for static analysis and writing grammar corrections.

Remember, THIS REPOSITORY IS A DESIGN REFERENCE, NOT RELIGIOUS RULES. In other words, they are OPINIONS.

Caution

DO NOT ATTEMPT TO RELIGIOUSLY ENFORCE your project layout based on this repository. IN NO WAY does this project force anyone to strictly adhere to these as rules.

Fanaticism destroys. Please act responsibly and sensibly. Adapt and reference.

The adaptive filesystem currently studies the following operating systems for its unification:

• Apple's iOS
• Apple's MacOS
• FreeBSD
• Linux-based OSes
• Microsoft Windows
• MVC|MVP Project Architectures
• MVVM Project Architectures
• VIPER Project Architectures

Important

For Linux-based OSes, this is the consolidated version of all its major distributions including but not limited to SystemD, FreeDesktop.org, Red Hat Linux, Debian, Devuan, Void Linux, Fedora, etc.

How to Use

To use this dataset, first set up the markdown rendering git repository server, for example:

https://github.com/ChewKeanHo/research-the-adaptive-filesystem

Then, you can browse each directory and read its README.md documentation describing its roles and responsibilities.

You can also use a UNIX program like tree to easily map out a directory hierarchy. The command is:

$ tree -a -d path/to/TARGET/

Verifying Content Integrity

To secure the content from unauthorized modification by anyone down to bit-level (0|1), they are cryptographically signed using one or more cryptography tools such as but not limited to:

• GnuPG; AND/OR
• OpenSSL.

The public key and the associated certificate are attached. Only the main owner keeps and maintains the private keys. To verify the content's integrity:

GnuPG

1. Install GnuPG software if not present.
2. Download the target file and its detached signature file (the .asc file with the same filename).
3. Download the public key file (.gpg).
4. Place them next to each other in the directory.
5. Open a terminal and execute the following command:

$ gpg --no-default-keyring --keyring /path/to/public.gpg --verify /path/to/file.asc

OpenSSL

1. Install OpenSSL software if not present.
2. Download the target file and its detached signature file (the .sig/.sign file with the same filename).
3. Download the public certificate file (.pem) containing the public key within.
4. Place them next to each other in the directory.
5. Open a terminal and execute the following command:

$ openssl dgst -verify /path/to/pubkey.pem -signature /path/to/file.sig /path/to/file

Design Sources & References

1. Please refer to REFERENCES.md for source and references list.

Artificial Intelligence (A.I.) Decrees

Please refer to AI_DECREES.md for the project's policy on the use of Artificial Intelligence.

Maintainers' Notes

1. Please refer to CONTRIBUTING.md for contributing & maintenances guidelines.

License

• Agreed GIMP License
• Agreed GIMP Privacy Policy
• Agreed Inkscape License
• Agreed Inkscape Privacy Policy
• Agreed LibreOffice License
• Agreed LibreOffice Privacy Policy

This entire repository is licensed under Creative Commons Attribution-NoDerivatives 4.0 International License. To ensure better understanding of this license, the following sub-sections will briefly describe how to deploy the content.

For registered non-profit organizations (NGO), you are considered a Commercial Entity the same as any for-profit organization by default. However, you will be eligible for the NGO disbursement grant and receive exception privileges from the creator(s).

Attribution

Unless otherwise specified in writing, you MUST attribute back to the creator(s) as follows:

Title: The Adaptive Filesystem
Creators: (Holloway) Chew, Kean Ho
Packaged-By: (Holloway) Chew, Kean Ho
Contact: hello@chewkeanho.com
SKU: chewkeanho-research-the-adaptive-filesystem
UUID: 3113F0A2-61BD-449C-BC0F-DE4C09997AC6
DOI: 10.5281/zenodo.17864564
License: Creative Commons Attribution-NoDerivatives 4.0 International License (https://creativecommons.org/licenses/by-nd/4.0)
Repository Made On: 2025-11-30
Repository Made From: Malaysia, South East Asia
Procure: https://doi.org/10.5281/zenodo.17864564

Ownership - Personal

Note

This targets any customer wanting to own a copy of the content and then only he/she is using it without sharing with any 3rd-party entity; AND WITHOUT any monetary intention such as but not limited to:

• Saving a local copy and then viewing via his/her own mobile device(s); OR
• Saving a local copy and then viewing via his/her own personal computer; OR
• Saving a local copy for artificial intelligence data training purposes.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Ownership - Commercial

Note

This targets any customer wanting to own a copy of the content and then only he/she is using it without sharing with any 3rd-party entity; AND WITH any monetary intention such as but not limited to:

• Saving a local copy for enhancing his/her company's procurement list; OR
• Saving a local copy for commercial artificial intelligence data training purposes.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Reference - Personal & Commercial

Note

This targets any customer wanting to refer or to provide a guide for sourcing the original content for any 3rd-party entity without directly displaying any portion of the original content; WITHOUT any monetary intention such as but not limited to:

• Academic research and paper writing; OR
• New content creation linking to the original content WITHOUT displaying any of the original content for his/her own streaming platform; OR
• Content production and collection linking to original content WITHOUT displaying any of the original content; OR
• Web portfolio project linking to the original content WITHOUT displaying any of the original content; OR
• Event materials linking the original content WITHOUT displaying any of the original content; OR
• Meeting materials linking the original content WITHOUT displaying any of the original content; OR
• Advertisement contents linking the original content WITHOUT displaying any of the original content.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Integration - Personal

Note

This targets any customer wanting to directly display portions and NOT ALL of the original content as it is OR without any composing remixes or modifications retaining the original intent, art direction and messages into his/her content creation; WITHOUT any monetary intention such as but not limited to:

• New content creation with displaying portion(s) of the original content for his/her own streaming platform without any monetary gain; OR
• Content production and collection with displaying portion(s) of the original content without any monetary gain; OR
• Web portfolio project with displaying portion(s) of the original content without any monetary gain; OR
• Event materials with displaying portion(s) of the original content without any monetary gain; OR
• Meeting materials with displaying portion(s) of the original content without any monetary gain.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Integration - Commercial

Note

This targets any customer wanting to directly display portions and NOT ALL of the original content as it is OR without any composing remixes or modifications retaining the original intent, art direction and messages into his/her content creation; WITH any monetary intention such as but not limited to:

• New content creation with displaying portion(s) of the original content for his/her own streaming platform; OR
• Content production and collection with displaying portion(s) of the original content; OR
• Web portfolio project with displaying portion(s) of the original content; OR
• Event materials with displaying portion(s) of the original content; OR
• Meeting materials with displaying portion(s) of the original content; OR
• Advertisement materials with displaying portion(s) of the original content.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Composition Remix - Personal

Note

This targets any customer wanting to own and then modify the original content extensively preserving or altering the original intent, art direction, or message for composing his/her new content creation; WITHOUT any monetary intention such as but not limited to:

• New content creation with digitally modified and processed original content integration for his/her own streaming platform WITHOUT any profits including advertisement commission; OR
• Personal content production and collection with digitally modified and processed original content integration for his/her own streaming platform WITHOUT any profits including advertisement commission; OR
• Personal web portfolio project with digitally modified and processed original content integration for his/her own streaming platform WITHOUT any profits including advertisement commission; OR
• Social media meme content creation with digitally modified and processed original content integration for his/her own streaming platform WITHOUT any profits including advertisement commission.

You are NOT ALLOWED due to the license restriction.

Composition Remix - Commercial

Note

This targets any customer wanting to own and then modify the original content extensively preserving or altering the original intent, art direction, or message for composing his/her new content creation; WITH any monetary intention such as but not limited to:

• New content creation with digitally modified and processed original content integration for his/her own streaming platform; OR
• Personal content production and collection with digitally modified and processed original content integration for his/her own streaming platform; OR
• Personal web portfolio project with digitally modified and processed original content integration for his/her own streaming platform; OR
• Social media meme content creation with digitally modified and processed original content integration for his/her own streaming platform.

You are NOT ALLOWED due to the license restriction.

Broadcast or Resell Redistribution - Personal

Note

This targets any customer wanting to share, to broadcast, to re-distribute, to sell, or to re-sell the original, modified, OR derived content WITHOUT any monetary intention such as but not limited to:

• Sharing with family members; OR
• Streaming the content via any streaming platform with private viewer access; OR
• Displaying the content in his/her gallery with privately invited guests; OR
• Displaying the content in private, free entry open spaces like living room; OR
• Owning a copy of the original content and serving it as downloadable content on a website in a private network (e.g. self-hosted home network); OR
• Sharing the original content across social media or messaging applications like email or instant messenger.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.

Broadcast or Resell Redistribution - Commercial

Note

This targets any customer wanting to share, to broadcast, to re-distribute, to sell, or to re-sell the original, modified, OR derived content WITH any monetary intention such as but not limited to:

• Streaming the content via any streaming platform with public or private viewer access; OR
• Displaying the content in any company's public events with free or payable guest invites; OR
• Displaying the content in any company's internal/private events with free or payable guest invites; OR
• Owning a copy of the original content and serving it as free OR payable downloadable content on his/her website in any network (Internet, Intranet, or private networks); OR
• Sharing the original content across social media or messaging applications like email or instant messenger; OR
• Distributing the original content via multiple profit-earning streaming platforms.

You are ALLOWED provided that you STRICTLY COMPLY with the license attribution.